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When it comes to 
software, nobody’s perfect. 
But according to many of the 
experts, one word processing 
program is as close as you can 
get. No wonder it’s called 
WordPerfect. 

What are all the critics 
raving about? 

Simplicity. Most 
WordPerfect functions 
require only one keystroke, a 
simple press of a finger. So 
you can concentrate on 
writing, not programming. 

Speed. Because it is 
document- 
oriented 
instead of 
page-oriented, 
WordPerfect 


won’t make you Digital Review 
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how fast 
you type, 
WordPerfect won’t slow you 
down. 

Features. From writers to 
doctors, accountants to 
lawyers, WordPerfect has 
built-in special functions to 
meet a wide variety of specific 
needs. And at SSI, every day 
is spent upgrading and 
improving WordPerfect — 


List Magazine 
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WordPerfect isn t flawless — 
- word processing software, 
but it comes very Close. 


perfection. 

Get your hands 
on the critics’ 
choice, WordPerfect 







word processing from SSI. 
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see your dealer. 
Or call or write: 

SSI Software 

288 West Center Street 
Orem, Utah 84057 
Information: (801) 224-4000 
Order Desk: 1-800-321-4566, 
Toll-free 


Reaching for perfection. 


The best of both worlds 
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Now, software developers can expand their markets and increase their 


productivity with Co-Idris™, the newest UNIX-like operating system from 
Whitesmiths, Ltd. 


Co-ldris is a professional, sophisticated tool enabling users to develop programs 
in a powerful and flexible UNIX-like environment, then easily port these 
applications to a wide range of PC/MS-DOS machines, including the IBM PC, 
DEC Rainbow, Wang PC, DG Desktop, and Olympia PC. With the Co-ldris 
package, you can construct C, Pascal, or assembler programs for operation 
under Co-ldris, DOS or CP/M-86. 


Able to work in as little as 128 KB of total main memory, Co-ldris allows 
concurrent access to both Idris-based programs and PC- or MS-DOS based 
application programs. You get the multi-user, multi-tasking features of a UNIX 
environment as well as the rich selection of DOS applications. And there is no 
need to reboot DOS, ever. 


Co-Idris works on most all PC/MS-DOS based configurations with hard disks, 
and it’s available now! 


Dealer inquiries invited. 


Whitesmiths, Ltd. 


97 Lowell Road Concord,MA01742 (617) 369-8499 
TLX 750246 SOFTWARE cNcM 





DISTRIBUTORS: Australia, Fawnray Pty. Ltd., Hurstville, (612) 570-6100; France Cosmic s.a.n.|. 76 Quai Des Carrieres, 94227 Charenton Le Pont 1-378-8357; 


Japan Advanced Data Controls Corp., Chiyoda-ku, Tokyo (03) 263-0383; United Kingdom, Rea! Time Systems, Douglas, Isle of Man 0624-26021; Sweden, Unisoft 


A.B., Goteborg, 31-125810. Rainbow is a trademark of Digital Equipment Corp. UNIX is a trademark of Bell Laboratories; MS-DOS is a trademark of Microsoft 
Corp. PC-DOS is a trademark of International Business Machines Corporation. Idris is a trademark of Whitesmiths, Ltd. 
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GENERATES CUSTOMIZED 
INPUT SCREEN PROGRAMS 
IN BASIC AND PASCAL eae 


THE 


SOFTWARE 
BOTTLING 
COMPANY 


OF NEW YORK 





BASIC or PASCAL. Easily! FULL FUNCTION SCREEN CREATION 


Generate programs in BASIC or PASCAL. 
Your choice. Works with * Turbo PASCAL, 
* IBM PASCAL or IBM BASIC (interpreter 
and Compiler). Easy to use. 

Begin productive use in minutes! 


Simply “draw” input screens with word processor style editor. 


Advance screen creating features include: 

e Draw boxes, lines, etc. in seconds with unique character selection menu. 
e Repeat last character in any direction. 

e Special color-select screen displays all available colors. 


e Paint and Repaint sections of screen at any time. 
POWERFUL SCREENS e Copy and Move sections of screen. 
Everyone can have professional quality e Insert or Delete characters and lines. 
screens to dress up any program. e Input field definition screen gives you total control of character type 
Generate complex, colorful, effective definitions, edit screen masks, input sequence, variable 


screens in minutes. names, initial values, protected characters, etc. 


COMPLETE DATA ENTRY ROUTINES 


Generates customized program code that allows professional quality data input using the full PC keyboard (cursor keys, delete, 
insert, and more). Checks input data for valid entries and displays error messages. 
Programs are easily merged with your own programs. 


Easy to follow documentation shows how and where you can modify the generated programs. 


e Available now with IBM PC, PCjr, PCXT, and all true compatibles. 
eRequires 128k RAM, one floppy disk drive, and PC DOS. Works with any 80 column display type. 


* Turbo PASCAL is a registered trademark of Boreland International, Ltd. IBM is a registered trademark of IBM corporation. 


TO ORDER SEE YOUR LOCAL DEALER 
OR CALL (718) 728-2200 


Credit Card Orders call 1-800-824-7888. Operator 268 
Only 34 2500 Alaska and Hawaii call 1-800-824-7919. Operator 268 


oes ‘ ten INQUIRIES INVITED. SORRY, NO C.O.D. 
dnctides ahtapiog and handc roduced and Distributed by The Software Bottling Co. of New York. 
(N.Y.S. Res. Add 8% % sales tax) 29-14 23 Ave., New York City, N.Y. ie 05 
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“Despite the recent press notices, 
multiuser microcomputers aren’t 
anything new!”’ 
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This is the first in a series of 
discussions with Rod Coleman, 
President of Stride Micro 
(formerly Sage Computer) on 
the 68000 multiuser market 
and its current environment. 


Q: Why do you say that? 

RC: ‘The technology to build a 
high performance multiuser sys- 
tem has been around for five 
years. And while some of the 
leaders in this industry have been 
pretending that micro multiuser 
didn’t exist, we’ve been shipping 
complete systems for nearly three 
years. The benefits of multiuser 
are undeniable; it is more cost ef- 
fective, and offers greater flexibil- 
ity and utility. But until just re- 
cently, the marketing pressure to 
be compatible instead of being 
better, has blinded the industry.’’ 


Q: What do you mean? 


RC: ‘‘Well, for example, the 
Motorola 68000 processor intro- 
duced 16/32-bit technology to the 
personal computer world a long 
time ago. It was fully capable of 





“A surprising feature is 
compatibility. Everybody 
talks about it, but nobody 
does anything about it.’’ 


meeting high performance and 
multiuser design requirements in 
1980. Instead of this trend taking 
off, most energy was spent pro- 
moting 8088/8086 products that 


were Clearly inferior from a tech- 
nical point of view. This phenom- 
enon leads me to believe that they 
will soon rewrite the old proverb: 
‘Build a better mousetrap and the 
world will beat a path to your 
door,’ but only if they can find the 
way through the marketing fog.’ 
Q: Are things changing now? 
RC: ‘‘Yes and no. With the busi- 
ness world starting to take more 
and more interest in microcompu- 
ter solutions, the advantages of a 
solid multiuser system couldn’t be 
kept hidden forever; companies 
like ours and a few others were 
beginning to make a dent. Instead 
of taking a fresh approach, some 
of the newest multiuser offerings 
will probably only give the tech- 
nology an undeserved black eye! 
Multiuser is far more than the 
ability to plug in more terminals. 
It involves things like machine 
compatibility, fast processors, 
adequate memory, large storage 
Capacities, backup features, net- 
working, and operating system 
flexibility.”’ 

Q: Is this what makes the new 
Stride 400 Series different? 

RC: ‘Exactly. That sounds self- 
serving, but it’s true. Today a 
number of companies are intro- 
ducing their first multiuser sys- 
tem. We’ve been building and 
shipping multiuser machines for 
almost three years. We know the 
pitfalls, we’ve fallen into some of 
them. But we have learned from 
our mistakes.”’ 


Q: Give me some examples. 


RG: A hard disk is almost manda- 
tory for any large multiuser in- 
stallation. Yet, backing up a hard 
disk can be a nightmare if you 
only have floppies to work with. 
That’s why we’ve added a tape 
backup option to all the larger 
Stride 400 Series machines. It’s 
irresponsible for a manufacturer 
to market a multiuser system 
without such backup. Another 
good lesson was bus design. We 
started with one of our own de- 
signs, but learned that it’s impor- 
tant not only to find a bus that is 
powerful, but also one that has 
good support and a strong future 
to serve tomorrow’s needs. We 






















states. That gives us a 25% in- 
crease over the Sage models. 
And, we have a 12 MHz pro- 
cessor as an option. Let me add 
that speed isn’t the only way to 
judge performance. I think it is 
also measured in our flexibility. 
We support a dozen different 
Operating systems, not just one. 
And our systems service a wide 
variety of applications from the 
garage software developer to the 
corporate consumer running high 
volume business applications.”’ 


Q: Isn’t that the same thing all 
manufacturers say in their ads? 


RC: *‘Sure it is. But to use another 
over used-term, ‘shop around’. 
We like to think of our systems as 
‘full service 68000 supermicro- 
computers.’ Take a look at every- 
one else’s literature and then 
compare. When you examine 
cost, performance, flexibility, and 
utility, we don’t think there’s any- 
one else in the —— 
race. Maybe 
that’s why we’ve 
shipped and 
installed more 
multiuser 68000 
systems than 
anyone else.”’ 





























“The marketing pressure 
to be compatible 
instead of being better, 
has blinded the industry.” 


think the VMEbus is the only de- 
sign that meets both criteria and 
thus have made it a standard fea- 
ture of every Stride 400 Series 
machine.’’ 


Q: What are some of the other 
unique features of the 400 Series? 


RC: ‘A surprising feature is com- 
patibility. Everybody talks about 
it, but nobody does anything 
about it. Our systems are com- 
pletely compatible with each other 
from the 420 model starting at 
$2900, through the 440, on to the 
powerful 460 which tops out near 
$60,000. Each system can talk to = 
the others via the standard built-in 
local area network. Go ahead and 
compare this with others in the in- 
dustry. You’ll find their little ma- 
chines don’t talk to their big ones, 
or that the networking and multi- 
user are incompatible, or that they 
have different processors or 
operating systems, and so on.’’ 
Q: When you were still known as 
Sage Computer, you had a reputa- 
tion for performance, is that still 
the case with the new Stride 400 
Series? 

RC: ‘‘Certainly, that’s our calling 
card: ‘Performance By Design.’ 
Our new systems are actually fas- 
ter; our standard processor is a 10 
MHz 68000 running with no wait 
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For more information on Stride or 
the location of the nearest Stride 
Dealer call or write us today. 
We’ll also send you a free copy of 
our 32 page product catalog. 








Corporate Offices: 


4905 Energy Way 
Reno, NV 89502 
(702) 322-6868 


Regional Offices: 


Boston: (617) 229-6868 
Dallas: (214) 392-7070 
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Masthead Changes 

This special Unix issue was conceived by Reynold Wiggins but he was absent from the 
delivery room. Midterm, Reynold removed his editor’s visor and threw away the nub of his 
red pencil to become a CAD programmer at Fairchild. So yours truly, Randy Sutherland, 
assisted the Doctor on this baby. Reynold Wiggins has been involved with Dr. Dobb's 
Journal almost since the beginning and we expect an ongoing relationship. When it comes 
to programming on microcomputers, it is hard to match his zeal! 

New names will appear on the masthead next month: Frank DeRose, Assistant Editor; 
and Alex Ragen, Technical Editor. 
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Next Year 
Next month we feature an article on how to “Fatten Your Mac” for a lot less than Apple’s 
price. Also, we will review Logitech’s Modula 2 compiler and STSC’s APL interpreter. 
February is the Gala Anniversary Issue, 100 months of DDJ! In March we focus on 
artificial intelligence for microcomputers and announce the winner of the AI competition. 
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Circulation Assistant Kathleen Boyd 





_ M&T Publishing, Inc. 
Chairman of the Board Ormar Weber 
Director C.F von Quadt 
President Laird Foshay 





Entire contents copyright © 1984 by M&T Publishing, 
Inc. unless otherwise noted on specific articles. All 
rights reserved. a 


Dr. Dobb’s Journal (USPS 307690) is published 


monthly by M&T Publishing, Inc., 2464 Embarcadero — 


Way, Palo Alto, CA 94303, (415) 424-0600. Second 
class postage paid at Palo Alto and at additional entry 
points, . | 

Address correction requested. Postmaster: Send Form 
3579 to Dr. Dobb's Journal, 2464 Embarcadero 
Way, Palo Alto,CA 94303. ISSN 0278-6508 
Subscription Rates: $25 per year within the United 
States, $44 for first class to Canada and Mexico, $62 








for airmail to other countries. Payment must be in U.S. - 


Dollars, drawn on a U.S. Bank. 


Contributing Subscribers: Christine Bell, W.D. 
Rausch, DeWitt S. Brown, Burks A. Smith, Robert C. 
Luckey, Transdata Corp., Mark Ketter, Friden Mail- 
ing Equipment, Frank Lawyer, Rodney Black, Kenneth 
Drexler, Real Paquin, Ed Malin, John Saylor Jr., Ted 
A. Reuss III, InfoWorld, Stan Veit, Western Material 
Control, S.P. Kennedy, John Hatch, Richard Jorgen- 
_ sen, John Boak, I : 

Subscribers: Michael S. Zick, F. Kirk. — 


Foreign Distributors: ASCII Publishing, Inc. (Ja- 








pan), Computer Services (Australia), Computer Store 
(New Zealand), Computercollectief (Nederland), Ho- — 


mecomputer Vertricbs GMBH (West Germany), In- 


ternational Presse (West Germany), La Nacelle Book-— 


store (France), McGill's News Agency PTY LTD 
(Australia), Progresco (France). 





People’s Computer Company 


Dr. Dobb’s Journal is published by M&T Publishing, 
Inc. under license from People’s Computer Company, 


non-profit, educational corporation. 


2682 Bishop Dr., Suite 107, San Ramon, CA 94583, a 


4 


Boak, Bill Spees, R.B. Sutton. Lifetime _ 


munications issue by the end of February. 


This Month’s Referees 


Dennis Allison, Stanford U. 

S. M. Bellovin, AT&T 

Wayne Chin, Hewlett-Packard 
Bob Desinger, Hewlett-Packard 
Mohammed El Lozy, Harvard U. 
Jim Fleming, Unir Corporation 


Angel Gomez, Telecomp, Inc. 
John Keyes, Microsoft 

Ben Laws, North Texas State U. 
John Rogers, Fortune Systems 
Joseph Sharp, 


Micro Science Associates 


STATEMENT OF OWNERSHIP, MANAGEMENT, AND CIRCULATION 
(Act of August 12, 1970, Section 3685, Title 39, United States Code) 


1. Title of Publication: Dr. Dobb's Journal, Publication No. 
307690. 


2. Date of Filing: October 12, 1984. 
3. Frequency of Issue: Monthly (12 issues, $25). 


4. Location of Known Office of Publication: 2464 Embarca- 
dero Way, Palo Alto, CA 94303. 


5. Location of Headquarters of General Business Offices of 
the Publishers: 2464 Embarcadero Way, Palo Alto, CA 
94303. 


6. Names and Addresses of Publisher, Editor, and Manag- 
ing Editor: Publisher, Laird Foshay, 2464 Embarcadero 
Way, Palo Alto, CA 94303. Editor, Michael Swaine, 
2464 Embarcadero Way, Palo Alto, CA 94303. Manag- 
ing Editor, Randy Sutherland, 2464 Embarcadero Way, 
Palo Alto, CA 94303. 


7. Owner: Otmar Weber, 2464 Embarcadero Way, Palo 
Alto, CA 94303; and C. F. Von Quadt, 2464 Embarcade- 
ro Way, Palo Alto, CA 94303. 


8. Known Bondholders, Mortgagees, and Other Security 
Holders Owning or Holding | Percent or More of Total 
Amount of Bonds, Mortgages or Other Securities: None. 


9. Extent and Nature of Circulation: 


A. Total number of copies printed: Average number of 
copies each issue during the preceding 12 months: 
31,407. Actual number of copies of single issue pub- 
lished nearest to filing date: 35,550. 


B. Paid Circulation. 1. Sales through dealers and carri- 
ers, street vendors, and counter sales. Average number 
of copies each issue during preceding 12 months: 
6.099. Actual number of copies of single issue pub- 
lished nearest to filing date: 6,625. 2. Mail subscrip- 


tions. Average number of copies each issue during pre- 
ceding 12 months: 18,268. Actual number of copies of 
single issue published nearest to filing data: 20,718. 


C. Total Paid Circulation. Average number of copies 
each issue during preceding 12 months: 24,367. Actual 
number of copies of single issue published nearest to 
filing date: 27,343. 

D. Free distribution by mail, carrier, or other means, 
samples, complimentary, and other free copies. Aver- 
age number of copies each issue during preceding 12 
months: 230. Actual number of copies of single issue 
published nearest to filing data: 587. 


E. Total distribution. Average number of copies each is- 
sue during preceding 12 months: 24,597. Actual num- 
ber of copies of single issue published nearest to filing 
data: 27,930. 


F. Copies not distributed. 1. Office use, left over, unac- 
counted, spoiled after printing. Average number of 
copies each issue during preceding 12 months: 1,820. 
Actual number of copies of single issue published 
nearest to filing date: 2,200. Returns from news 
agents. Average number of copies each issue during 
preceding 12 months: 4,990. Actual number copies of 
single issue published of nearest to filing date: 5,420. 


G. Total. Average number of copies each issue during 
preceding 12 months: 31,407. Actual number of copies 
of single issue published nearest to filing date: 35,550. 


I certify that the statements made by me above are correct and 


complete. 


Laird Foshay, Publisher 


Dr. Dobb's Journal. December 1984 


SOFTWARE TOOLS FOR ADVANCED PROGRAMMERS 


Dr. Dobb's journal 








ARTICLES 


Varieties of Unix 24 A comparative overview of Unixes for microcomputers 
by Alan Walworth with a brief history of Unix and comments on its future, 
plus a guide to choosing a Unix (Reader Ballot No. 192) 
Unix Device Drivers 38 Unix Version 7 drivers are the point of departure for this 
by John Bass inside look at the Unix I/O subsystem and Unix device 
drivers (Reader Ballot No. 193) 
A Unix Internals Bibliography 50 = Anexpert’s guide to internals documentation so you won’t 
by John Rogers have to “grep for it” (Reader Ballot No. 194) 
A File Browser Program 60 For those times when all you want to do is look through a 
by John Johnson file (Reader Ballot No. 195) 
An Introduction to Parsing 78 How to implement parsing schemes for assemblers, 
by Henry Seymour editors, or adventure games (Reader Ballot No. 196). 
COLUMNS 
Dr. Dobb’s Clinic 16 Around and around with Shugarts and Tandons (Reader 
by D. E. Cortesi Ballot No. 190). 
CP/M Exchange 20 The early days of CP/M: Using large sectors (Reader 
by Bob Blum Ballot No. 191). 
16 Bit Software Toolbox 88 Sneak 80286 Preview (Reader Ballot No. 197) 
by Ray Duncan 
C/Unix Programmer's Notebook 96 Long pointer corrections, programming philosophy 
by Anthony Skjellum (Reader Ballot No. 198) 
Computer Calisthenics 120 Puzzles (Reader Ballot No.199) 
by Michael Wiesenberg 
DEPARTMENTS 
Editorial 6 
Letters 8 
Software Reviews 106 NCI Coherent, Turbo Pascal Version 2.0 (MSDOS and 
CP/M) 
Of Interest 124 (Reader Ballot No. 200) 
by R. P. Sutherland 
Advertiser Index 128 


Dr. Dobb’s Journal, December 1984 


DITO) 7a 





October 15 to attend a Unix Expo; I was not alone in finding the show 

slow and boring. (Well, not entirely boring; I did see some C program- 
ming tools that were of some interest, Jim Joyce’s seminars seemed well-attend- 
ed, and one company was showing off an intriguing product that implements 
Smalltalklike object-oriented programming in a Unix environment, but the show 
attendance was sub-moblevel.) 2) I drove up the peninsula to San Francisco on 
October 26—27 for the PC Faire; the Faire did nothing to reassure me that Unix 
is on the verge of taking over the exciting world of IBM PCs and compatibles. 
(OK, I did see some friendlifying frontends for PC Unixes. ) 3) Dr. Dobb’s read- 
ers have read all the inflated claims about Unix market share, don’t believe them, 
and anyway don’t read DDJ for that sort of thing; as one irascible newsletter 
editor who pontificates under the name Felgercarb N. Eloi recently wrote, oat 
was absurd to assert that Unix was or ever would be the best operating system for 
the dentists and candle-makers who comprise the mass personal computer mar- 
ket.” (But many of our readers do use Unix.) 

Argument for doing a special Unix issue: our readers are not dentists or 
candlemakers. 

This special issue on Unix is a new departure for DDJ. We have in the past 
done special issues on Forth and telecommunications, and current plans call for 
us to continue doing these special issues. We will in fact be doing more special 
issues in the future. But we’re changing our approach to them: instead of devot- 
ing an entire month of the magazine to a topic, we are now shining a more 
focused light on the topic at hand, leaving room for other articles in the same 
issue. The idea is that we’re consciously structuring these special sections to deal 
in some depth with a relatively narrow slice of an interesting topic. 

Consider the current issue’s special section, which we have named Inside Unix. 
Here’s what we think we have done here; you can let us know how well we 
succeeded. The Unix section includes only three articles (plus the regular “C/ 
Unix” column and attention to Unix in ‘‘Of Interest”’), and it centers on the Unix 
drivers article by John Bass. 

The Bass article is directed at people who want something more than market- 
ing hype on how many Unix licenses have been sold, or analysis of where Unix 
fits into the office of tomorrow. It takes you deeper into the Unix system, hence 
the section title Inside Unix. 

Rogers’ richly annotated bibliography of Unix internals is again not for the 
tyro but is a useful tool for the programmer with a need to know about Unix 
internals. We hope to supply such bibliographies whenever they are appropriate. 
The overview article by Walworth is here to provide a background for the other 
pieces and to clear up some confusion about versions of Unix for those who 
haven't got it all quite straight. 

You’re right if you’re thinking that all this is some kind of experiment. As 
Castle, the slanderous stereotype of a humanities professor in B.F. Skinner’s 
Walden II, said, the experimental attitude has the wonderful feature of letting 
one be utterly confident and self-righteous without knowing anything. We’re 
experimenting, cautiously, with the magazine, and once we see the results of our 
present experiments, we’ll probably continue experimenting. 


Michael Swaine 


‘ rguments for not doing a special issue on Unix: 1) I flew to New York on 
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C ENGLISH. 


The C Generation Language. 


What is CENGLISH? cENGLISH is a comprehensive fourth generation 
procedural language based on dBASE II” syntax. It is portable to a 
wide range of micros and minis. The language features user-trans- 
parent interfaces to a wide range of popular C compilers, operating 
systems, and data base managers. 


How is portability achieved? cENGLISH through its compiler inter- 
face translates CENGLISH into documented C source and uses a host 
C compiler to produce native machine code. 


CENGLISH 
SOURCE 


C source can be embedded in cENGLISH source. 


Differences in the operating system and data base manager are 
handled by the runtime libraries. 


The result is that CENGLISH source can be compiled without modi- 
fication on any micro or mini configuration supporting CENGLISH. 


What about performance? cENGLISH executes FAST, just like any 
compiled C program. 


How easy is CENGLISH to use? While cCENGLISH is a powerful high 
level language that can accommodate complex software develop- 
ment, it remains simple and straightforward to use. 


Call or write for availability of CENGLISH for the following configu- 
rations— 
Compilers: 

Standard O/S compilers: Lattice C™ for MS/DOS” 
Operating Systems: 

UNIX; UNIX-like, MS/DOS;" Coherent” VMS” 
Data Base Managers: 

C-ISAM” and INFORMIX? UNIFY,” ORACLE” PHACT,” Logix” 
Foreign Language Versions: 

German, French, Spanish 


Attention MS/DOS users. Demo version and special introductory offer 
available for IBM PC* XT,” AT,” and other MS/DOS systems. 
Requirements: 256K, hard disk or two floppy disk drives, and 
MS/DOS 2.1 or higher. 

Attention dBASE Il and dBASE Ill users. dBASE II to CENGLISH 
Converter now available; dBASE III Converter available later this 
quarter. Converted code is portable to micros or minis and executes 
as fast as original CENGLISH source. 





EXECUTABLE 
MACHINE CODE 








S 
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BASE Il and dBASE Ili are trademarks of Ashton-Tate. Lattice is a trademark of Lattice, Inc. UNIX is a trademark of Bell Laboratories. 
MS/DOS is a trademark of Microsoft, Inc. Coherent is a trademark of Mark Williams Company. VMS is a trademark of Digital Equipment 
Corporation. C-ISAM and INFORMIX are trademarks of Relational Database Systems, Inc. Oracle is a trademark of Oracle Inc. PHACT 
is a trademark of Phact Associates. Logix is a trademark of Logical Software, Inc. IBM PC XT and AT are trademarks of International 
Business Machines Corporation. UNIFY is a trademark of Unify Corp. 
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SAMPLE CENGLISH PROGRAM 


IDENTIFICATIONS 
MODULE: Mininame 
AUTHOR: bcs 
DATE: 8/29/84 
REMARKS: Sample cENGLISH program that adds first 
names to a file 
END IDENTIFICATIONS 



















GLOBALS 
FIXED LENGTH 1 ans 
FIXED LENGTH 15 Fname 

END GLOBALS 








MAIN PROGRAM 


BEGIN 
CLEAR SCREEN 
SET ECHO OFF 


USE “NAMES” 
VIEW BY “ID_FNAME” ASCENDING 












AT 23,1 SAY “Add a record? Y or N” 
AT 23,25 ENTER ans USING “!’” 


WHILE ans EQ “Y” 
CLEAR GETS 
AT 6,1 SAY “Enter first name” 
AT 6,20 GET Fname 

READ SCREEN 


INSERT 
Fname = Fname 
END INSERT 












AT 1 “4 10 SAY “Welcome to cENGLISH” & Fname 
WAI 

AT 14,10 SAY “HIT ANY KEY TO CONTINUE” 
STORE “ “TO Fname 
STORE“ “TOans 

AT 23,1 SAY “Add another record? Y or N’ 

AT 23,30 ENTER ans USING “I” 

CLEAR ROW 1 THRU 23 


END WHILE 








AT 12,10 SAY “That's all for now!” 
UNUSE “NAMES” 
SET ECHO ON 


END PROGRAM 






Please send further information. 





Your Name Title 

Company Telephone 

Address 

City State Zip 
Check one: ([JEnd User [1 System House (J) Dealer (Distributor 








Send to: CLINE Inc., 20 West Ontario, Chicago, IL 60610-3809 
Telex 516315 Phone (31 2} 944-4510 


In Canada: CLINE Canada, Inc. Complexe La Laurentienne, 
Phone (418) 524-4641 


Circle no. 19 on reader service card. 


LETTERS 


Forum 


Dear DD, 

I was interested to see Alex Cameron’s 
contribution of standard (K&R) fopen- 
/fclose functions for BDSC in the Au- 
gust °84 Dr. Dobb’s Journal (“BDSC 
Runtime Solution,” page 118). I con- 
tributed code with a similar goal to the 
C User’s Group over two years ago. 
Cameron took the conventional ap- 
proach of using alloc/free to allocate 
buffer space in the “heap,” the region 
of memory between the top of the exter- 
nals and the bottom of the stack. | was 
more concerned to avoid the tendency 
to allocate too many buffers and bash 
the stack, so I #defined the maximum 
number of buffers (simultaneously 
open files) as NIOBUFS before main( ), 
and reserved the buffers in the external 
data space. Thus, inadequate memory 
problems would be obvious at link time. 
My code was set up to be #included at 
three points in main( ). I have recently 
ported eleven substantial programs 
from BDSC to Computer Innovations 
C86 and found the use of standard 
fopen/fclose to be a real help. 

More recently, along with a text for- 
matter which I wrote, I contributed a 
library of 43 general purpose functions 
to the C User’s Group (“Martz Library 
Disk”). Your readers writing in C may 
save some time by getting a copy of 
these. Most of the functions are for 
character string manipulation. For ex- 
ample, argmatch( ) finds arguments to 
main( ) in any sequence, with leading / 
trailing ambiguities, optionally deleting 
them from the argc, argv list once 
found. fbrkout( ) breaks a long string 
into pieces of specified width and hands 
it to an output stream. Breaks are be- 
tween words. It has options for indenta- 
tion and for representing non-printable 
characters. badname( ) verifies that a 
filename is valid according to CP/M 
file-naming rules; if not, it issues a de- 
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tailed error message. findwords( ) 
counts the number of words in a string 
and sets up an array of pointers point- 
ing to each. pack( ) packs strings into a 
big buffer for later retrieval, returning 
a pointer to the beginning of each. sub- 
stitute( ) replaces all instances of a 
specified string with a specified replace- 
ment. todelim( ) finds the first instance 
of a specified delimiter (which can be 
one or more characters) and splits the 
original string into left and right por- 
tions excluding the delimiter. ynqd(_) is 
one of the most useful: “Yes No Ques- 
tion with Default.” As an example of its 
use, to ask whether the user needs help: 


if (ynqd(‘‘Do you need help”, YES)) 
givehelp( ); 


This displays on the console: 


Do you need help? (y/n) 
(default = YES) 


Simply hitting a carriage return [sig- 
nals] the default YES .... In addition 
to my own modest contributions, many 
others have contributed tools and pro- 
grams totaling about forty 8-inch SSSD 
CP/M disks. Readers programming in 
C should avail themselves of these by 
writing to the C User’s Group, 112 N. 
Main, Box 287, Yates Center, KS 
66783; phone 316-625-3553. Six issues 
of the CUG Newsletter are $10, and 8- 
inch SSSD CP/M disks are only $8. Sev- 
eral 5-inch disk formats are also avail- 
able (Apple II, Heath/ Zenith, TRS-80, 
Northstar, Osborne, and others). 

Sincerely, 

Eric Martz, Ph.D. 

48 Hunter’s Hill Circle 

Amherst, MA 01002 


Dear DDJ, 

I read the article by Joe Barnhart 
about the fast Fourier transform (FFT) 
in the September 1984 issue. A disad- 


vantage of the FFT is that all the num- 
bers in the transform are complex, re- 
quiring complex arithmetic. A 
complex addition requires two addi- 
tions of real numbers, and a complex 
multiplication requires four real multi- 
plications and two real additions. The 
user has to use twice as much memory 
to store a complex array of numbers 
for the FFT. I know of variations of the 
FFT algorithm that repack the real in- 
put numbers into a complex array half 
the original length. The FFT is per- 
formed and the result unpacked. The 
FFT of the repacked array uses less op- 
erations. However, the packing and 
unpacking algorithms are complicated. 

An alternative to the FFT is the fast 
Hartley transform (FHT). The Hartley 
transform is similar to the Fourier 
transform, except that the input and 
output numbers remain real. Since 
most applications of the Fourier trans- 
form usually involve real input data, the 
FHT is more suitable for the average 
user. Since the FHT does not involve 
any complex operations, the FHT re- 
quires fewer multiplications and addi- 
tions than the FFT algorithm presented 
in the article. The basic equation for N- 
point Fourier transform is 


N-I 
Xf(k) = X x(n) (cos (2a / N) nk) 
n=0 
—isin((27 / N) nk)) 


where x(n) is the complex input, Xf(k) 
is the Fourier transform, and 7 is the 
square root of —1. The equation for 
the N-point Hartley transform is 


N-1 
Xh(k) = = x(n) (cos ((27 / N) nk) 
n=0 
+ sin((2a / N) nk)) 


where x(7) is the real input and X7(k) 
is the Hartley transform. Note that the 
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Hartley transform does not have any 
complex arithmetic involved. The in- 
verse Fourier transform is different 
from the forward Fourier transform. 
The inverse Hartley transform is the 
Same as the forward Hartley trans- 
form. The FFT makes use of the sym- 
metry of the Fourier transform, which 
leads to the butterfly graph shown in 
the article. The Hartley transform also 
has a symmetry which leads to a FHT 
algorithm that uses a double butterfly 
graph. The user can switch the results 
from a Hartley transform to the Fouri- 
er transform through the equations 


REAL[X;(k)] 
= [Xh(k) + Xn(—k)]/2 


IMAG[X;(k)] 
= [Xh(k) —Xh(—k)]/2 


Enclosed [see Listing One on page 12] 
is a C listing of a subroutine that per- 
forms a FHT. Many common opera- 
tions of the frequency domain are com- 
puted faster in the Hartley domain. 
For example, convolution and cross 
correlation require fewer operations 
when done with the Hartley transform. 
I hope you will let your readers know 

about the Hartley transform, because 
it is better suited for small computer 
systems than the Fourier transform. 
For a good reference, see Ronald 
Bracewell’s article, “The Fast Hartley 
Transform” in the August 1984 issue 
of Proceedings of the IEEE. Another 
reference is my article “An Algorithm 
for the Fast Hartley Transform” in the 
Stanford Exploration Project #38. 

Sincerely, 

Ron Ullmann 

Picture Element Ltd. 

635 Waverly 

Palo Alto, CA 94301 


Dear Doctor: 
In a recent issue, a reader told you 
about how a patch to the DRI macro- 
assembler RMAC, which he received 
from Manx, solved his need to use un- 
derscores and periods in identifiers. 
Anyone mixing C or Pascal with as- 
sembly language modules linked to- 
gether will find this enhancement to 
RMAC useful. 

Because the above-mentioned patch 
may have wide appeal to your audience 
of system hackers, I am including a list- 
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Still Fixing Bugs 
The Hard Way? 


Ready to take the sting out of 
debugging? You can with 
Pfix86™ and Pfix86 Plus™, the 
most advanced dynamic and 
symbolic debuggers on the 
market today for PC DOS and 
MS-DOS™ programmers. 

What other debugger offers 
you an adjustable multiple- 
window display so you can view 
program code and data, break- 
point settings, current machine 
register and stack contents all 
at the same time? And, an in- 
line assembler so you can make 
Program corrections directly in 
assembly language. Plus, pow- 
erful breakpoint features that 
allow you to run a program at 
full speed until a loop has been 
performed 100 times, or have 
the program automatically jump 
to atemporary patch area. 

Or maybe you're tired of 
searching through endless piles 
of listings for errors? With Pfix86 
Plus you won’t have to. You can 





locate instruction and data by 
the symbolic name and using 
the symbolic address. Handle 
larger, overlayed programs 
with ease. And, Pfix86 Plus is 
designed to work with our 
Plink86™ linkage editor. 

But that’s not all. With a single 
keystroke you can trace an in- 
struction and the action will be 
immediately reflected in code, 
data, stack, and register win- 
dows. Pressing a different key 
will elicit a special trace mode 
that executes call and loop 
instructions at full speed, as 
though only a single instruction 
were being executed. 

And you get an easily acces- 
sible menu that makes the 
power of our debuggers instant- 
ly available to the new user, but 
won't inhibit the practiced user 

So, why struggle with bugs? 
Pfix86 by Phoenix. Pfix86 $195. 
Pfix86 Plus $395. 

Call (800) 344-7200, or write. 


She om : 
Phoenix Computer Products Corporation | 
1416 Providence Highway, Suite 220 


Norwood, MA 02062 


In Massachusetts (617) 762-5030 


Pfix86, Pfix86 Plus and Plink86 are trademarks of Phoenix Software Associates Ltd. 
MS-DOS is a trademark of Microsoft Corporation 


Circle no. 70 on reader service card 





AT LAST 


S-100 <> 488 


THAT 
DOES 
EVERYTHING 
YOU 


WANT 


IT TO DO 


D&W DIGITAL, INC. 
20655 Hathaway Avenue 
Hayward, California 94541 
(415) 887-5711 
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ing [see Listing Two on page 13] that 
achieves the purpose, and which can 
also be customized for MAC. This same 
listing was available from several bulle- 
tin boards, but given the huge amount 
of software that those boards carry, it 
might have been unnoticed by many. 

I would like to point out that any 
potential commercial firm interested 
in this patch should make arrange- 
ments with me prior to using it. 

In an entirely different matter, Ray 
Duncan and thereafter some readers 
discovered many problems with 
MASM, the Microsoft/IBM 8086 ma- 
croassembler. It’s a sorry state of af- 
fairs that some companies can provide 
such low level of quality to the market- 
place and still be praised by much of 
the press. But the reason I’m writing 
you about this is that I’m using two 
versions of MASM; one is 1.07 and the 
other is 2.04. The former one seems to 
have less problems than the 2.04. 
Many of the bugs found by Mr. Dun- 
can are not present in version 1.07, 
which seems to perform normally in 
these tests. I would recommend read- 
ers to try to obtain this version and see 
if I’m right. 

Some other bugs are still present, 
even in this better version, plus prob- 
lems resulting from being a two-pass 
assembler. I don’t know or have 
RASM, but ASM-86, which comes 
with CP/M86, is a three-pass assem- 
bler, which allows it to do a better allo- 
cation of space before actually starting 
the assembly. This eliminates many 
nonsense NOPs that MASM needs to 
scatter through the object code, de- 
grading even more a slow-performing 
chip like the 8088. 

Regards, 

George Blat 

Blat Research + 
Development Corp. 
8016 188th Street SW 
Edmonds, WA 98020 


Dear DDJ, 

“Designing a File Encryption System” 
(DDJ, August 1984) by Thomas and 
Thersites is delightful. Can you imag- 
ine the hilarity in the halls at the Puz- 
zle Palace when their cafeteria serves 
recycled permutation table genera- 
tors? I can just see the FBI on stakeout 
at the embassy supermarkets watching 
for a surge in sales of one pound bags 


of leguminous encryption aids. 
Sincerely, 
Adam Fritz 
133 Main Street 
Afton, New York 13730 


DRI Support 


Dear Editor: 

I am writing in response to Steve Con- 
ley’s letter in the August issue of Dr. 
Dobb’s Journal. Mr. Conley described 
a bug he found in RMAC. He was up- 
set when people at Digital Research 
told him that they didn’t know when, 
or if, the problem would be fixed. I 
would like to address several of the 
concerns which he raised. 

It has always been Digital Re- 
search’s policy to be honest with our 
customers. I truly wish we could fix all 
the bugs in all of our products as fast as 
we would like. Unfortunately, the real- 
ity is that this doesn’t happen. Instead 
we try to prioritize problems and do all 
we can to make sure our customers are 
aware of them. Fixing this problem has 
a low priority because it is possible to 
work around the problem and because 
RMAC is an 8-bit product. If we had 
promised Mr. Conley that the problem 
would be fixed “soon” he probably 
would have been satisfied. I firmly be- 
lieve, however, that it is much better to 
be honest. Therefore the engineer de- 
scribed the status of the problem to 
Mr. Conley and discussed with him 
two possible work arounds for the 
problem. To me this represents quality 
support rather than indifference. 

Providing quality technical support 
to a large customer base can be diffi- 
cult. The method which we have cho- 
sen to provide this support is our Pro- 
fessional Programmer Support 
Program (PPS). PPS includes unlimit- 
ed toll-free phone access to our engi- 
neers, a technical newsletter and a sub- 
scription to CompuServe so that the 
customer can access our data bases. 
This package is available for only $250 
per year for each customer contact 
person. 

I think that PPS is what Mr. Conley 
was referring to when he mentioned a 
$250 software maintenance package. 
Maintenance, however, is available to 
all registered users of our products. 
We use the registered users data base 
to notify customers whenever a new re- 
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The C Pre 
from 


MWC86 gets yo 
ning faster and use 
than any other comp 
Then csd, Mark Willia 
C Source Debugger, help 
faster. That’s The C Progra 
tem from Mark Williams Compa 


MWC86 


MWC86 is the most highly optimized 
C compiler available anywhere for the 
DOS and 8086 environment. The bench- 
marks prove it! They show MWC86 is 
unmatched in speed and code density. 

MWC86 supports large and small 
models of compilation, the 8087 math 
coprocessor and DOS 2.0 pathnames. 
The compiler features common code 
elimination, peephole optimization and 
register variables. It includes the most 
complete libraries. Unlike its competi- 
tion, MWC86 supports the full C lan- 
guage including recent extensions such 
as the Berkeley structure rules, voids, 
enumerated data types, UNIX* I/O calls 
and structure assignments. 

Quality is why Intel, DEC and Wang 
chose to distribute MWC86. These in- 
dustry leaders looked and compared 
and found Mark Williams to be best. 


User Friendly 


MWC86 is the easiest to use of all 
compilers. One command runs all 
phases from pre-processor to assembler 
and linker. MWC86 eliminates the need 
to search for error messages in the back 
of a manual. All error messages appear 
on the screen in English. 

A recent review of MWC86 in 
PC World, June, 1984, summed it up: 


*Unix is a Trademark of Bell Laboratories. 




















“Of all the compilers reviewed, MWC86 
would be my first choice for product 

development. It compiles quickly, pro 
duces superior error messages, and 
generates quick, compact object ¢ 
g library is small and fast ax 
the industry stay 


Ser 


>was not content to 

write the best C compiler on the mar- 
ket. To advance the state of the art in 
software development, Mark Williams 
wrote csd. 

csd C Source Debugger serves as a 
microscope on the program. Any C 
expression can be entered and evalu- 
ated. With csd a programmer can set 
tracepoints on variables and expressions 
with full history capability and can 
single step a program to find bugs. The 
debugger does not affect either code 
size or execution time. csd features 
online help instructions; the ability to 
walk through the stack; the debugging 
of graphics programs without disturb- 
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it C did for Programming 
s has done for C Programming 


ing the program under test; and evalu- 
ation, source, program and history 
indows. 

csd eases the most difficult part of 
development — debugging. Because 
csd debugs in C, not assembler, a pro- 
grammer no longer has to rely on old- 
fashioned assembler tools, but can 
work as if using a C interpreter — in 
real time. 


The C Programming System 
from Mark Williams now supports 
the following libraries: 


Library Company 
Windows for C Creative Solutions 
Halo Media Cybernetics 
PHACT PHACT Associates 
The Greenleaf Functions Greenleaf Software 
Btrieve SoftCraft 


The C Programming System 
from Mark Williams 


The C Programming System from 
Mark Williams delivers not only the 
best C compiler for the 8086 but also 
the only C source level debugger. That’s 
why it does for C programming what C 
did for programming. The Mark Wil- 
liams C Programming System gives the 
programmer the MWC86 C compiler 
and the csd C Source Debugger for 
only $495. Order today by calling 
1-800-MWC-1700. Major credit cards 
accepted. 

Technical support for The Mark Wil- 
liams C Programming System is pro- 
vided free of charge by the team that 
developed it. 


Mark Williams Company 
1430 W. Wrightwood Ave. 
Chicago, IL 60614 





lease is available. Unfortunately we 
could not find Mr. Conley at the ad- 
dress he listed as either a subscriber to 
PPS or as a registered user. Because of 
this, we will not be able to notify him 
when updates occur for any of his DRI 
products. 

Mr. Conley mentioned problems he 
has had reaching DRI by phone. Re- 
cently we have made some improve- 
ments so that it is now relatively easy 
to reach our Warranty Support De- 
partment. They do not provide custom- 
ers with technical support but do pro- 
vide customers with warranty support. 
Their number is (408) 646-6464. 

In summary, I am very proud of the 
support we, at DRI, provide our cus- 
tomers. I believe we have found a very 
good way to provide a much needed 
service to our customers. 

Sincerely, 
Marion Brown 
Support Center Manager 





le f f ers (Text begins on page 8) 
Listing One 


160 Central Avenue 
Pacific Grove, CA 93950 


Caveat Emptor 


Dear DDJ, 

The purpose of this letter is to warn Dr. 
Dobb’s readers of problems in dealing 
with JRT. 

Early in June of this year I called 
JRT on the phone and ordered a copy 
of their Modula-2. I was told that the 
product would be shipped within a 
week. On 20 June my VISA account 
was billed $102.95 for Modula-2 plus 
shipping. 

When the product had not arrived 
by August, I tried over a period of 
three weeks, repeatedly and at all 
hours, to reach JRT at their listed 
phone. The phone was never answered. 
Finally, at the end of August I sent 
JRT a certified letter, return receipt re- 
quested, describing the situation and 


Fast Hartley Transform 


/* The FHT performs the fast Hartley transform over an an array of 


* floating point numbers. 


The array of real numbers are pointed to by 


asking that either my copy of Modula- 
2 be shipped or that my VISA account 
be credited. The return receipt came 
back to me on 7 September, signed by 
Jim Tyson of JRT. 

It is now 24 September and I have 
heard nothing from JRT, I have not re- 
ceived Modula, and my VISA account 
has not been credited. While most of 
my experience ordering from comput- 
er suppliers has been extremely satis- 
factory, I think JRT’s actions, taking 
your money and not shipping the prod- 
uct, are at best a sharp business prac- 
tice and, at worst, border on fraud. 

Sincerely, 

R. A. Langevin 

7621 Fontaine Street 
Potomac, MD 20854 


DD] 





¢ FX. LENGTH is the number of points in the array and must be a power of 
* two (i.e. 16, 32, 2048). The Hartley transform of the array is stored 


* in the array FX upon completion. 


* returns a value of —1. 
us é 

(length, fx) 

int length; double *fx; 


If LENGTH is not a power of two, FHT 
Otherwise, FHT returns 0. By Ron Ullmann 


int ii, kk, jj, ll, istep; 


double 
double 


*pba, *pbb, *pbe, *pbd; 
tempi, temp2, arg, fcos, fsin, dsin, dcos; 


/* Test to see if length is a power of two and is not zero. */ 
for (kk = length; (kk & 1) == 0; kk >>= 1) ; 


if (kk != 1) return (-1); 
/* Reorder the data */ 


arg = sqrt (1. / (double) length); 


=. 


/* scale the data */ 


Be (ii = 0, kk = O; ii < length; ++ii, kk += jj) 


if (ii <= kk) 


temp1 ‘= *(fx + kk) * arg; 


*(fx + ii) 


oe + kk) = *(fx + ii) * arg; 


temp1; 


for (jj = length>>1; kk >= jj && jj >= 1; kk —= jj, jj >>= 1); 


arg = 3.141592653589793238462643; 


ot (jj = 1; jj < length; jj = 


istep = jj << 1; 
dcos = cos (arg); 
arg /= 2 


istep) 


dsin = sin (arg); 


for (ii = 0; ii < length; ii += istep) 


pba = fx + ii; 


pbc = pba + jj; 


temp1 = *pbe; 


*pbc = *pba — templ; 
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*pba += templ; 
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feos = dcos; fsin = dsin; 
for (le = "1; kk = jf 2 I <p Sn) asl kk ee 2) 
r f for (ii = ll; ii < length; ii += istep) 
f pba = fx +-ii; pbb = pba + kk; 

pbc = pba + jj; pbd = pbc + kk; 
templ = fcos * *pbe + fsin * *pbd; 
temp2 = fsin * *pbc — fcos * *pbd; 
*pbc = *pba — tempi; *pbd = *pbb — temps; 
*pba += templ; *pbb += tempa; 


templ = fcos*dcos — fsin*dsin; 
fsin = fsin*dcos + fcos*dsin; fcos = templ; 
if (jj > 1) 
for (ii = (jj >> 1); ii < length; ii += istep) 
pba = fx + ii; pbc = pba + jj; 
templ = *pbc; *pbc = *pba — templ; 
*pba += temp!1; 


return (0); 
} /* end of FHT */ End Listing One 
Listing Two 


CREEK KEKKEKKEKKEKEKKKKKEKEKKEKKEKKKKKKEKKEKKKEKKEKKEKKKKEKKKKKEKEKKEKKKKKKKKEKREKE 


Patches for MAC and RMAC 


by George Blat 
Blat, Research + Development Corp. 
80916 188th SW 
Edmonds, WA 98@2@ 


RREKEKKEKEKKKEKEKKEKKKEKEKKKE KEKE KEKKKKKK EK KKK KK KKEKEKKKKEKKKKKKKKKKKKKKKKKKEK 


eo “=e ™e Se Se Se MO MO Me Be WE Me WE 


f 

;The following changes are (c)1983 Blat R+D Corp. Permission is 
;gGranted to use these patches only in non-commercial applications. 
;MAC and RMAC are trademarks of Digital Research, Inc. which holds 
;Ownership and all rights to the original programs. 


KK KKKKKEKEKKKKEKKEKKEKKKKE KKK KKK KEKE KKK KKK KKK KEK KKK KEKE KKK KKEKKKREE 


= = 


=e ™e 


;Mac and Rmac are two reliable assemblers developed by Digital 
;Research which have a good number of useful features. It seems 
;natural to get the most out of them, 

‘ 

;Among the features that can be added to Mac and Rmac, are the 
zability to use the period '.' and the underscore ' ' as part of 
;symbol names such as labels, even as first character of the 
;symbol. The underscore, for instance, makes a much better word 
;separator than the dollar 'S$' sign when used in a multi-word 
;label. In a dense program listing, it's certainly easier to find 
;STAT_PORT than STATSPORT, and @hl_to de than @hlS$to$de. 


4 


;By the same token, I don't agree with the decision of Digital 
;Research of making the dollar sign a don't care character. It 
;introduces confusion as it allows symbols that don't look the 
;same to be equivalent. 


‘ 

;In addition, RMAC can be easily patched to create .REL files 
;where the global (external) names have up to 7 active characters. 
;This helps by allowing you to create more meaningful symbol names 
;and therefore improve program legibility. This change is still 
;entirely compatible with the industry standard Microsoft format. 


4 

;The following patches should be assembled with MAC (not RMAC) ' 
;and the resulting hex file should be applied over the original 

;Pprograms with DDT, SID or ZSID. KEEP AN ARCHIVE COPY OF THE 

; ORIGINAL MAC OR RMAC BEFORE PATCHING. 


false equ g 
true equ not false (Continued on next page) 
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Le f f ers (Listing Continued, text begins on page 8) 


Listing Two 


rmac equ 
mac equ 


if 
global7 


patcharea 
dollarcounts 


checkalfa 
toup 
endif 


if 
copyrite 
dollarcounts 
checkalfa 

endif 


if 


org 
db 

patcharea: 
endif 


if 
org 
endif 


cpi 
FS 
cpi 
CZ 
cpl 
rz 
cpi 
rz 
if 
call 
endif 
sui 
cpi 
cmc 
ret 


if 


compare equ 
setit7 equ 


org 
cpi 
org 
mvi 


endif 


ae 
org 
nop 
endif 


org 
call 
cmc 


sbb 
ret 


end 
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true 

false 

rmac 

equ true 
equ 13bh 
equ ld7ah 
equ 1d9ch 
equ 28 44h 
mac 

equ 193h 
equ 1834h 
equ 1853h 
mac 

copyrite 


eC)19772DRT' 


rmac 
patcharea 


rmac 
toup 


‘A! 
Cor LA RELY 


rmac and global7 


12d6h 
12dbh 


compare 
8 
setit7 
Bigt 


dollarcounts 
dollarcounts 


checkalfa 
patcharea 


;select one and only one of these 


strue 


;set to false if you don't want 


>7 char globals 


sset this to false if you like to 
skeep the dollar as a don't care char 


sshorten but keep the copyright notice 


;replaces cpi 7 


;replaces mvi a, 


;replaces mov m, 


;replaces cpi 3f 


3)z ldbl 
scpi 4G 
Ps i ldbl, 


6 


a 


etc. 





End Listing Two 
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At Christmas I no more 
desire a rose 


Than wish a snow in May's 
new fangled mirth 

But like of each thing 
that in season grows 

— King Lear 
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MacInker 


A Gift For Christmas 
A Gift For All Seasons 


If Shakespeare had had a word pro- 
cessor he would have consumed about 
25 cartridges to run a first draft of his 
works, At an average of $10/cartridge 
the cost is $250. With MAC INKER he 
would use one cartridge, his total would 
be 50 cents in ink and his print-out 
quality would be much improved. 


MAC INKER is very simple to use and 

automatic. Average ink cost/re-inking is 
9 cents. We support 535 printers and we 
have 20,000 units in the field, in the US 


and in 5 continents. 


MAC INKER, a gift for Christmas, that 
will last for years in seasons to 


94.95+ 












acSwitch 


Choose also our popular MAC SWITCH, 
serial or parallel switch - the ideal com- 
panion for the user who has 2 printers or 
2 microcomputers or $39.00 






Order toll free 1-800-547-3303 
or ask for free brochure 


& 
C#:mputer Friends 
6415 S.W. Canyon Court 
Suite #10 
Portland, Oregon 97221 
(503) 297-2321 
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“.. .C86 was the only compiler we tested that 


ran every benchmark we tried and gave the 


expected results... Computer Innovations 


C86 was the compiler that our staff 
programmers used both before and six 
months after we conducted the tests.” 


*FAST EXECUTION - 
of your programs. 


*FULL & STANDARD 
IMPLEMENTATION OF C - 

includes all the features described by 
K & R. It works with the standard 
MSDOS Linker and Assembler; many 
programs written under UNIX can 
often be compiled with no changes. 
*8087 IN-LINE - 

highly optimized code provides 8087 
performance about as fast as possible. 
*POWERFUL OPTIONS - 

include DOS2 and DOS1 support and 
interfaces; graphics interface capability; 
object code; and librarian. 


Join The Professional Programmers Who Agree C86™ Is The C Compiler Of Choice 


For Further Information Or To Order Call: 


800-922-0169 


Technical Support: (201) 542-5920 





*FULL LIBRARY WITH SOURCE - 

6 source libraries with full source code 
the “large” and “small” models, soft- 
ware and 8087 floating point, DOS2 
and DOSALL. 

*FULL RANGE OF SUPPORT 
PRODUCTS FROM COMPUTER 
INNOVATIONS - 
including Halo Graphics, Phact File 
Management, Panel Screen Manage- 
ment, C Helper Utilities and our 
newest C_to_dBase development 
tool. 


*HIGH RELIABILITY - 


time proven through thousands of 
users. 


*DIRECT TECHNICAL 


SUPPORT - 
from 9 a.m. to 6 p.m. 


980 Shrewsbury Avenue 
Suite PW509 
Tinton Falls, NJ 07724 


PRICES SUBJECT TO CHANGE WITHOUT PRIOR NOTICE 
UNIX IS A TRADEMARK OF BELL LABS CS IS A TRADEMARK OF COMPUTER INNOVATIONS, INC MSDOS 1S A TRADEMARK OF MICROSOFT 
PCDOS IS A TRADEMARK OF INTERNATIONAL BUSINESS MACHINES 
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by D. E. Cortesi, Resident Intern 


The Intern Loses His Head: 
A Cautionary Tale 


It was a dark and stormy night. Rain 
lashed against the windows of the Clin- 
ic. The Intern sprawled across a gur- 
ney. He pushed his mask aside and 
slurped from a paper cup of coffee. 
Winced. Sighed. And spoke, his voice 
barely audible above the wind. “I lost a 
patient,” he said. “It was my own 
damn fault, sheer arrogance. But I 
paid forit....” 


The New Drives | 

I had a pair of Shugart 800s (he went 
on), single-sided 8-inch drives. They 
worked fine, but I wanted more. Six 
hundred Kb just isn’t enough for some 
of the things I do. Double-sided drives 
have 1200K, and with 256 directory 
entries they’d hold any project short of 
the U.S. Census. 

And they’re much faster—you know 
me and speed. Modern drives step at 3 
milliseconds, twice as fast as my old 
drives, and with twice the data under 
the heads they incur fewer and shorter 
seeks on the average. 

But I wanted not merely new drives 
but half-height drives. No practical 
reason—just because they’re sexy. Oh, 
a pair of half-heights is a lot less bulky 
than two normal drives, but my real 
motive was... aesthetic. 

So I placed an order with Floppy 
Disk Services (741 Alexander Road, 
Princeton, NJ 08540; 800-223-0306) 
for an enclosure with power supply, 
two drives, and a cable. It cost just over 
$1300. 

Floppy Disk Services will configure 
just about any combination of drives, 
and I had to choose a make of drive. 
Here was the first place I really went 
wrong. I asked for Shugart 860s for no 
better reason than that the old Shu- 
garts had given such good service. If 
I'd only asked for advice—from FDS 
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or a local guru—TI wouldn’t have ended 
up holding a detached head in my 
hand. 


The Interface 

The disks came a month later. The en- 
closure was handsome, the power sup- 
ply looked sturdy, and the drives were 
... aesthetically delicious. Open cut- 
outs on the back panel might have al- 
lowed air to shortcut the fan, but a 
piece of cardboard from the shipping 
carton blocked them neatly. 

I knew that all drives have a zillion 
jumper options and that the odds 
against FDS plugging them right for 
my system were astronomical, so I'd 
ordered the Shugart manual. That was 
a good move. The manual made it glar- 
ingly obvious that floppy technology 
had changed quite a bit since my disk 
controller, a venerable CCS 2422, had 
been designed. 

My first problem was how to control 
the drive motors. The old drives rotat- 
ed all the time but only closed the 
heads onto the disk when the 1793 as- 
serted the head-load line (clack!). 
When five index holes passed without 
any activity, the 1793 would automati- 
cally reset the head-load (clink!) so the 
disk could turn freely. 

The new drives loaded the heads as 
soon as a disk was inserted. The way 
their options were strapped on arrival, 
they would rotate the disk as long as 
the drive-select line was asserted. My 
BIOS (which followed the original CCS 
BIOS) never cleared the drive-select 
port, so the last-used drive would ro- 
tate indefinitely—with the heads 
pressing on the disk. Not good. 

The new drives allowed a jumper op- 
tion that would start the motor only 
when the drive was selected and the 
head-load signal was asserted. Anoth- 
er option would keep it turning for 5 
seconds after the fall of head-load then 
stop it. These options solved the first 


problem very nicely. 

They also created the second prob- 
lem. The new drives might take 168 
milliseconds to come up to speed after 
head-load was asserted. On the other 
hand, they might be ready to go in- 
stantly—if the motor were still turning 
from the last access. How could the 
1793 controller chip know when to 
wait for the motor to start and when it 
needn’t wait? 

Well, these drives emit a signal that 
was new to me. The line, True Ready, is 
pin 8 of the interface. The drive asserts 
it when the motor is up to speed and the 
head is stable; this is exactly what the 
1793 chip needs to tell it to go ahead 
with a read or write. What’s more, the 
1793 has an input, Head-Load Timing, 
that takes exactly that information. 
Unfortunately, pin 8 on my hoary old 
disk controller board is a no-connect. 
The Head-Load Timing input to the 
1793 is developed by a 50 millisecond 
one-shot on the board itself. 

OK, I told myself, that’s why I own 
an X-acto knife and a soldering iron, 
isn’t it? It took most of a weekend to 
work out that it is possible, using only 
existing components of the CCS 2422 
board, to implement True Ready as the 
Head-Load Timing signal of the 1793. 
And it worked. I got the Shugart 860s 
reading and writing with all four heads. 


The Decapitation 

After a few days, drive B started to fail 
intermittently. Sometimes it was “re- 
cord not found’; sometimes it was a 
CRC error on a sector ID; sometimes 
an error on a sector proper. Strange 
thing, it was worse with Dysan disks 
than with junk disks. 

OK, now I had a choice. I could refit 
the old drives, pack up the new ones, 
cart them to the UPS office, pay to ship 
them back to New Jersey, and wait 
(how many weeks?) for them to come 
back. Or I could take off the cover and 
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have a peek myself. One little peek 
wouldn’t hurt. 

With the covers off, I could hear the 
problem. The rotational speed was 
varying enough to be audible. Was it a 
bad motor? No! There was simply too 
much pressure on the disk jacket. The 
drive has a spring-loaded shoe that 
bears down on the disk jacket. I put out 
a cautious pinky and lifted the shoe: 
the disk sped up and a bad sector be- 
came readable. I released it: the drive 
slowed down audibly and an error oc- 
curred. Maybe the Dysan disks had 
thicker jackets or a little more internal 
friction. 

This is the point at which I lost the 
patient. I looked into the drive and de- 
cided that the pressure of the shoe was 
set by the position of a big plastic cam. 
The same cam raised the head and 
tripped the eject arm when the drive 
was opened. Its position was main- 
tained by two setscrews. They were cov- 
ered with touch-me-not varnish. Should 
I ship the drives back, or should I get 
out a screwdriver and try an adjust- 
ment? You can guess what I did. 

The cam adjustment was tricky. The 
cam worked against a heavy torsional 
spring that fought every move. Worse, 
after I started tinkering, it dawned on 
me that it wasn’t the cam at all. The 
pressure shoe just floated in it, held 
down by a weentsy little spring of its 
own. I got the cam back where it 
should be, more or less, fixed the shoe 
pressure, and buttoned it up. And it 
worked! My goodness, was I relieved. 
Maybe I had flubbed a little, I told my- 
self, but, by golly, I had diagnosed and 
repaired the problem. 

Ah, the bliss of ignorance. That big 
spring was working away on the head- 
lift cam, gradually shifting the set- 
screws. The head was lifting less and 
less when the disk was ejected. I noticed 
a little extra noise when the disk popped 
out of the drive but thought nothing of 
it. Until the drive quit working. 


Catastrophe! 
It wouldn’t read or write on side one. I 
took the cover off again and looked in- 
side, and a bowling ball dropped into 
my stomach. The upper head was dan- 
gling on its fragile wires, completely 
detached from the arm! 

A quick look with a dental mirror re- 
vealed the awful truth. In the Shugart 
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860, the upper head is suspended in a 
plastic frame. The sum total of its sup- 
port is a pair of tiny bronze straps. They 
are less than a millimeter wide and no 
thicker than a sheet of paper. If the 
head doesn’t lift far enough, the edge of 
the disk jacket will tweak it as the disk 
pops out. The head will flop back and 
forth on these flimsy metal straps. Do it 
often enough, the straps will fail and 
the head will dangle on its wires. 

OK, there I was with a thoroughly 
inop drive and not a prayer of making a 
warranty claim. So I started making 
phone calls, trying to find a profession- 
al to fix the drive. What I got was more 
bad news bulletins than a stock ticker 





Save 


possible! 


If you’re a C language 
programmer whose patience is 
wearing thin, who wants to spend 
your valuable time programming 
instead of twiddling your thumbs 
waiting for slow compilers, who 
just wants to work fast, then it’s 


BDS C features include: 


¢ Ultra-fast compilation, linkage and 
execution that produce directly 
executable 8080/Z80 CP/M command 
files. 
A comprehensive debugger that 
traces program execution and 
interactively displays both local and 
external variables by name and 
proper type. 
¢ Dynamic overlays that allow for run- 
time segmentation of programs too 
large to fit into memory. 





source code. 


Plus... 





Reviewers everywhere have 
praised BDS C for its elegant 
operation and optimal use of 
CP/M resources. Above all, BDS C 
has been hailed for it’s remarkable 
speed. 


BYTE Magazine placed BDS 
C ahead of all other 8080/Z80 C 
compilers tested for fastest 
object-code execution with all 
available speed-up options in use. 
In addition, BDS C’s speed of 





CP/M-80 C Programmers .. . 


... with the BDS C Compiler. Compile, link 
and execute faster than you ever thought 


err nO 


¢ A 120-function library written in both ¢ An attractive selection of sample 
C and assembly language with full 


¢ A thorough, easy-to-read, 181-page 
user's manual complete with 
tutorials, hints, error messages and 
an easy-to-use index — it's the 
perfect manual for the beginner and 
the seasoned professional. 


eee — — — — — —— 


fast as its closet competitor 
(benchmark for this test was the 
Sieve of Eratosthenes). 


“T recommend both the 
and the implementation 
by BDS very highly.” 
Tim Pugh, Jr. Free shipping on prepaid orders inside 
in Infoworld USA. 
“Performance: Excellent. 
Documentation: Excellent. 
Ease of Use: Excellent.” 
InfoWorld 
Sortware Report Card 
“... a superior buy...” 


compilation was almost twice as Van Court Hare not currently available for CP/M-86 or MS- 
in Lifelines/The Software 0S: 
Magazine 


in 1927. 

The first guy I talked to told me 
that, although Shugart 800s were 
“built like Mac trucks, they run forev- 
er, the 860 half-heights were “uh, 
let’s say, a little fragile. You shoulda 
got the Tandon 848-2, it’s a real nice 
drive.” Thanks for the tip; what about 
replacing the upper head? 

No, the only repair unit for the heads 
was the entire head assembly, upper 
and lower both, and it cost just under 
$300. Fine, I said, that’s less than a 
whole drive, when can we get one? 

That could be a problem, I was told. 
“We think of Shugart as being three 
miles and thirty days away. We might 








time 





time you programmed with the 
BDS C Compiler. 

BDS C is designed for 
CP/M-80 and provides users with 
quick, clean software 
development with emphasis on 
systems programming. 















programs, including MODEM- 
compatible telecommunications, 
CP/M system utilities, games and 
more. 









e A nationwide BDS C User's Group 
($10 membership fee — application 
included with package) that offers a 
newsletter, BDS C updates and 
access to public domain C utilities. 
















Don’t waste another minute on 
a slow language processor. Order 
your BDS C Compiler today! 









Complete Package (two 8” SSDD disks, 
181-page manual): $150 








VISA/MC, COD’s, rush orders accepted. 
Call for information on other disk 
formats. 













BDS C is designed for use with CP/M-80 
operating systems, version 2.2. or higher. It is 









BD Software, Inc. 
P.O. Box 2368 
Cambridge, MA 02238 
(617) 576-3828 
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NEW FEATURES 


(Free update for our early customers!) 
e Edit & Load multiple memory 
resident files. 
e Complete 8087 assembler 
mnemonics. 
e High level 8087 support. 


Full range transcendentals 
(tan, Sin, cos, arctan, 
logs and exponentials) 


Data type conversion and 
1/O formatting. 

e High level interrupt Support. 
Execute Forth words from with- 
in machine code primitives. 

e 80186 Assembler extensions for 
Tandy 2000, etc. 

e Video/Graphics interface for 
Data General Desktop Model 10 


SFO RTH 


e Fully Optimized & Tested for: — 





IBM-PC IBM-XT IBM-JR 
COMPAQ EAGLE-PC-2 
TANDY 2000 CORONA 


LEADING EDGE 


(Identical version runs on almost all 
MSDOS compatibles!) 


e Graphics & Text 
(including windowed scrolling) 


e Music - foreground and 
background 

includes multi-tasking example 
Includes Forth-79 and Forth-83 
File and/or Screen interfaces 
Segment Management Support 
Full megabyte - programs or 
data 


e Complete Assembler 
(interactive, easy to use & learn) 


e Compare 
BYTE Sieve Benchmark jan 83 
HS/FORTH 47sec BASIC 2000 sec 
w/AUTO-OPT 9sec Assembler 5 sec 
other Forths (mostly 64k) 70-140 sec 
FASTEST FORTH SYSTEM 
AVAILABLE. 
TWICE AS FAST AS OTHER 


FULL MEGABYTE FORTHS! 
(TEN TIMES FASTER WHEN USING AUTO-OPT!) 


HS/FORTH, complete system only: $250. 


we Visa Mastercard oa 


Add $10. shipping and handling 


HARVARD 
SOFTWORKS 


P.O. Box 2579 
Springfield, OH 45501 
513/390-2087 


Circle no. 44 on reader service card. 
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get lucky and have your part in three 
weeks. Probably more, though, since 
Shugart has given up on that drive.” 

They have? I called Shugart. Yes, a 
nice lady in Marketing told me, they 
were no longer selling the 860. She 
thought it might be because the market 
for 8-inch drives was so much smaller 
than that for 5-inch ones. No, it defi- 
nitely was not because the 860 was a 
bad drive. They were still making the 
800 model, and they'd support the 860 
for several years. Repair parts? Cer- 
tainly; just call our one and only official 
distributor in Los Angeles. 


The Tandon 848 

So I’ve got not just a busted drive but a 
busted orphan drive, see? I’m out at 
least three weeks and $300 for a new 
head assembly, then I'll have a work- 
ing orphan drive. Rubbish. I called Pri- 
ority One Electronics. What about the 
Tandon? Sure, it’s a fine drive, we 
have ’em in stock, and they are 100% 
compatible. Plus they’re on sale. 

The new Tandon came in only two 
weeks, but the Tandon manual didn't; it 
was back ordered. The drive has at least 
as many jumper options as the Shugart, 
but (of course) they had different 
names silk-screened onto the board. 
The piece of cardboard that was stuffed 
into the drive’s gullet to keep the heads 
apart during shipping had a cryptic ta- 
ble of jumper options. Some of the fac- 
tory settings it showed didn’t match the 
reality of the board. Others it named 
turned out not to be jumpers at all but 
traces that could be cut or soldered. 

I called Priority One repeatedly; I 
even talked them into reading me the 
Tandon manual over the phone. The 
guy who read it to me was not the 
world’s best interpretive reader. I got 
the impression that I couldn’t use True 
Ready and control the motor with 
Head-Load Timing at the same time. 
There were too many ambiguities. 

Finally, the manual arrived. With 
tax it cost just under a dollar a page. 
You know, the one really good thing 
about the Shugart 860 drives is the 
manual. It is clear and well organized. 
The Tandon manual isn’t. Its descrip- 
tion of the jumper options is cryptic, 
ambiguous, and actually wrong in a few 
places. No wonder I'd been confused by 
a hasty reading over the phone! 

Fortunately, the drive itself is nice. 


Much better than the Shugart. I can’t 
say how robust the head suspension is, 
since the head assembly is invisible and 
I have no intention of taking a screw- 
driver to that drive. But it’s much quiet- 
er in operation. The Shugart (the re- 
maining 860 is now drive B) inakes a 
harsh buzz when it seeks and loud snap- 
ping noises as its door-lock solenoid op- 
erates. The Tandon seeks with an oily 
purr that’s barely audible over the hum 
of a cooling fan. 

The Shugart doesn’t know where its 
head is when it powers up; until it is 
homed, it won’t read reliably. The 
Tandon homes itself when power is ap- 
plied, so it is ready to go on the first 
command. 

The Tandon isn’t really compatible, 
though. Oh, it responds to the same 
commands the same way—almost. But 
its power supply connector isn’t the 
same, and the threaded holes for side 
mounting are in different places than 
the Shugart. The Shugart door handle 
opens left; the Tandon opens to the 
right. The Shugart will seek to, and 
write on, track 77 (the 78th track), but 
the Tandon will go not-ready if you try 
that. I know, because my disk format 
routine had an off-by-one error that 
didn’t show up until I tried it on the 
Tandon. 

“Anyway, that’s how I lost a drive 
and some downtime and about $600. I 
have my half-heights now, though, 
even if they are of different makes. 
Plus an extra drive I can cannibalize 
for spare parts—poor headless thing.” 

The Intern tossed the crumpled cof- 
fee cup toward a box of bloody listings. 
“Thanks for listening.” He wandered 
off down the hall, a rumpled figure un- 
der the cold lights. The wind howled 
outside, and the rain streamed down 
the windows. 


DD) 
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A Real-Time Experience 


Learning how to program was the easy 
part. Now, what are you going to do 
with your knowledge? How about 
writing a check balancing program? 






Maybe you could start developing that 
wonderful data base to keep track of 
everyone’s birthdays. However, there 
are more interesting challenges. 

Computers are very useful for track- 
ing and filing information. There’s 
more to computing than just manipu- 
lating data. There’s walking, talking, 
singing, listening, touching, and con- 
trol. The computer’s most powerful 
function is control. 


Real-time computer techniques can 
control factories and machinery, mon- 
itor your home environment and pro- 
tect it from intruders, and operate lit- 
tle mechanical friends which will take 
out the garbage. 

The near future will show us ma- 
chines which respond to human voice 
controls, are capable of finding their 
Own way around a house or factory 
floor, and are able to make their own 
decisions. Robotics Age teaches you to 
design and work with the practical 
real-time applications of state-of-the- 
art microcomputer technology. Robots 
are simply machines which respond to 
their environments and can act on 
their own. Computers make these ma- 
chines possible. 

After all, many people claim their 
computers are user friendly—but how 
can your computer be user friendly if 
it doesn’t come when it’s called? 

It’s time for you to experience 
Robotics Age. Explore the frontiers of 
microprocessor applications. Use the 
subscription form below to start the 
flow of vital technical information you 
need. 


Sign me up TODAY for my personal 
subscription to Robotics Age, 
The Journal of Intelligent Machines. 


YES! 


US Subscriptions 





Non US Subscription Rates: 
Payable in US funds, drawn on a US bank. 


O12 issues $24 Subscription length will be adjusted down- 
[| 24 issues $45 ward on a pro-rata basis for any currency 
(_] 36 issues $63 conversion charges. Foreign subscription 


orders may be paid in US dollars via Master- 








Canada & Mexico Card or VISA. 

(] 12 issues $28 

(] 24 issues $53 

L) 36 issues $75 

Foreign on) 

CJ 12 ies (surface) $32 aaa! 

(} 12 issues (Air Mail) $68 

} 24 issues (surface) $61 

C24 issues (Air Mail) $133 RETURN WITH PAYMENT To: 

(_} 36 issues (surface) $87 Robotics Age, Box 358 
( 


ee eres Air hal) Peterborough, NH 03458 
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Company 
Address 
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State Zip/Postal Code | Country 
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Expiration Date 
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by Robert Blum 


I’ve run a little late completing the 
subroutine to handle buffered disk I/O 
that I promised to run this month. In 
its place I want to talk about the early 
years of CP/M and how it became the 
most popular operating system for 8- 
bit computers. I also want to touch on 
the benefits of using disk sectors larger 
than 128 bytes. Both of these topics 
were requested by some nice folks that 
I recently met at a user group meeting. 
They thought a discussion without the 
bits and bytes, or at least minimizing 
the technical details, would be most 
helpful—especially for the hobbyist 
who is new to CP/M and isn’t familiar 
as yet with assembly language 
programming. 


In the Beginning 

From its inception, CP/M was targeted 
for the 8008’s successor and Intel’s lat- 
est brainchild, the 8-bit 8080 micro- 
processor. While a software consultant 
for Intel, Dr. Gary Kildall had written 
the earliest versions of CP/M for his 
own experimental machine. His origi- 
nal development system included one 
of Shugart Associates first 8-inch disk 
drives, which had just come from 
equipment life testing and was about 
to take its last step. Fortunately, plenty 
of magic was left to finish CP/M. No 
one realized it at the time, but the com- 
bination of the 8080 CPU, CP/M, and 
two 8-inch disk drives was soon to be- 
come the standard of the then fledgling 
personal computer industry. 

Within a few years, the price of the 
8080 had dropped from its original 
$400 — $500 level to one that permitted 
a number of small companies (many 
working out of basements and garages) 
to begin shipping reasonably priced mi- 
crocomputers, mostly as kits, to a grow- 
ing audience of enthusiastic hobbyists. 
Although you couldn’t do much more 
than programming for grins in 8K of 
memory, it became obvious very quick- 
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ly that one important element was miss- 
ing: an operating system capable of 
supporting disk file management. 

The decision of several companies 
not to develop their own operating sys- 
tem and the inability of others to deliv- 
er a suitable product were primarily 
responsible for CP/M’s becoming to- 
day’s pseudo-standard. Several of the 
first companies to adapt CP/M for 
their products made disk drive subsys- 
tems for S-100 bus-compatible ma- 
chines. The prominence of the S-100 
bus at this time focused even further 
emphasis on CP/M and detracted from 
other specialized research and devel- 
opment projects. 

The average early microcomputer 
sported a 2 MHz clock rate and gener- 
ally used less than the maximum 64K 
of main memory, placing obvious limi- 
tations on the resources available to 
CP/M. This limited environment 
helped sharpen the basic design goal of 
CP/M: to provide a straightforward, no 
nonsense approach to a single-user op- 
erating system. 

Within just a few years, CP/M was 
offered on practically every 8080-com- 
patible 8-bit computer system built 
and was being adapted or at least 
planned for every new system to come 
along. This nearly universal accep- 
tance of CP/M heightened the need for 
enhancements to the disk interface 
portion of the BDOS to ease the adap- 
tation process. 

Version 2.2 of CP/M was brought 
out in the early ’80s. Its most exciting 
feature was a new, flexible, table-driv- 
en generic disk interface and the abili- 
ty to address larger capacity disk 
drives. Not only was the job of integra- 
tion greatly simplified, but the flexibil- 
ity of the new interface allowed many 
new storage options to be offered by 
the computer manufacturers. It soon 
became common to offer several dif- 
ferent disk capacity options for the 


same computer. 

Within the last year, DRI has re- 
leased its latest revision of CP/M 
called CP/M Plus. This version turns 
out to be a completely new system, 
structured for an environment that in- 
cludes expanded memory of at least 
96K. As expected, when given enough 
memory to perform all of its magic, 
CP/M Plus can improve the runtime of 
programs that make heavy use of the 
disk system. 

For over 10 years, CP/M has led the 
way in 8-bit operating systems; it con- 
tinues today to maintain its position of 
prominence by having more installed 
systems than any competitor. Since 
those early days, CP/M has gone 
through a number of upgrades but no 
change in philosophy. It remains the 
same rock-solid generic disk operating 
system that we have grown up with. 


How It Operates 

CP/M is simple-minded in its dealings 
with the host I/O system (BIOS). The 
rules are few; as long as they are reli- 
giously followed, the marriage will re- 
main a peaceful one. 

The portion of CP/M that intercedes 
between the computer’s hardware and 
the BDOS is the BIOS. Contained in the 
BIOS are all the machine-dependent 
routines needed to interpret CP/M’s 
language to that of the hardware sys- 
tem. One major task of the BIOS, and 
probably the most important, is to 
maintain peace and order over the disk 
system. 

Most of the time during a disk I/O 
operation is spent waiting for the 
drive’s mechanical apparatus to prop- 
erly position itself for the data trans- 
fer. Consider for a moment the number 
of interrelated mechanical events that 
must happen in precise order to pre- 
pare for a single data transfer. First, 
the spindle motor is started and al- 
lowed to stabilize at a constant speed. 
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Next, the heads are loaded against the 
disk surface. Finally, the heads are 
stepped in or out to the proper track. 
At this point, to search for the request- 
ed sector and transfer it requires only a 
few additional milliseconds. 

To complete the startup cycle and 
read one record on even the latest mod- 
el disk drive can account for a delay of 
as much as one-third to one-half of a 
second. If this seems like a long time, it 
is—certainly long enough to be worthy 
of efforts to reduce it to a bare mini- 
mum. It’s not hard to estimate how 
slowly a program would run if a com- 
plete startup cycle were necessary for 
each data record read. It stands to rea- 
son that as much data as possible 
should be transferred during each 
cycle. 

The complexity of the BIOS is large- 
ly dependent on the hardware and 
whether the physical disk records are 
larger than CP/M’s logical sector size 
of 128 bytes. If, for example, the disk 
being used is formatted with a physical 
sector size of 128 bytes, the BIOS has 
the fairly uncomplicated job of in- 
structing the disk controller hardware 
where to put each data sector as direct- 
ed by the BDOS. Depending on the 
hardware, this task can be as simple as 
loading several registers with the track 
and sector values and initiating the 
1/O operation by loading an instruc- 
tion into the command register. If you 
are using one of the newer intelligent 
disk controllers that address the disk 
through data block numbers rather 
than by actual sector and track num- 
bers, the job is slightly more compli- 
cated; some calculations are necessary 
but only a few. 

The introduction of CP/M 2.x 


brought with it the ability to easily use 
physical sector sizes larger than the 
standard logical sector size of 128 
bytes. At this time, two new buzz words 
became prominent when referring to 
disk systems: single-density describes 
disk formats in which both the logical 
and the physical sector sizes are 128 
bytes in length, and double-density is 
used to describe almost any disk format 
where more than one logical sector is 
contained in a physical sector. This new 
version of CP/M also made it easier for 
the system integrator to fine tune the 
disk system to the computer system. 
There are two reasons for complicat- 
ing what was once the very simple issue 
of disk I/O. Changing the physical 
disk sector size from 128 to 512 bytes, 
for example, should in theory increase 
the disk system’s throughput by a fac- 
tor of four because four times as much 
data is being moved in one operation: 
for each sector read from the disk, the 
next three reads should be satisfied di- 
rectly from memory and at memory 
speed. In theory this may be true, but 
other factors generally prevent an in- 
crease of this magnitude. A goal of 
twice as fast is probably more in order. 
Another benefit of using larger disk 
sector sizes is that you can store more 
data on the same size disk. Most of the 
recording area of a disk is used for stor- 
age of control information that sepa- 
rates the physical sectors and describes 
the contents of the data record. For ex- 
ample, each data record area is preced- 
ed by a series of sync bytes to assist the 
hardware in locking onto the recorded 
signal. Once in phase with the recorded 
signal, the data record descriptors, the 
data record, and a few error-checking 
bytes are read from the disk. To in- 
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crease the data content in each sector 
from 128 to 512, for example, would 
require reducing the number of sectors 
and slightly changing the amount of 
control information and its content. 

A perfect example of this is the dou- 
ble-density disk format used by Inter- 
continental Micro Systems (ICM). 
The standards published by Western 
Digital (ICM uses its 2793 disk con- 
troller chip) specify that, to ensure re- 
liable operation, a maximum of 
15-512 byte sectors be allocated to 
each track of an 8-inch disk. After ex- 
haustive testing, ICM found that it 
could reliably format each track with 
16-512 byte physical sectors. For- 
matting its double-density disks in this 
way permitted ICM to achieve the 
maximum possible disk capacity with- 
out using the extra memory required 
by an even larger sector size. 


Using Large Sectors 

To use physical sectors larger than 128 
bytes requires that two routines be 
present in the BIOS. The first routine, 
blocking, maps CP/M’s logical sector 
requests into the larger host buffer. 
The other routine, deblocking, per- 
forms the opposite operation of ex- 
tracting the proper logical sector from 
the host buffer. 

Imagine for a moment that a memo- 
ry area 512 bytes in length has been set 
aside and divided into four 128-byte 
increments. Each of the 128-byte in- 
crements corresponds to a CP/M logi- 
cal sector, and the entire 512-byte area 
corresponds to the host physical sector. 
When CP/M makes its first logical 
write request, the data is moved from 
the DMA address to the first slot in the 
host buffer. The second CP/M write re- 
quest is placed into the second position 
of the host buffer, and so on until the 
fourth and last logical sector slot has 
been filled; the host buffer now must 
be emptied or data will be destroyed. 
From this example, we can see that us- 
ing larger physical sectors allow the 
number of actual disk I/O requests to 
be reduced. 

When CP/M makes a logical sector 
read or write request, the request is ac- 
companied by the actual sector and 
track numbers. These two values are all 
that is needed to calculate exactly 
which host buffer contains the request- 
ed sector and where the sector is within 
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the buffer. If the request is a read, the 
host buffer is read into memory and the 
logical sector extracted. The buffer is 
kept intact in hopes that other sequen- 
tial read requests will be made that can 
be satisfied directly from memory. 

On the other hand, write requests 
are a little more difficult. Not only 
must the system place the record to be 
written into the proper slot in the host 
buffer, but any other data in the same 
buffer must not be disturbed. This usu- 
ally requires that the host buffer first 
be read into memory, then modified by 
inserting the logical sector, and finally 
written back to disk. As before, the ac- 
tion of restoring the updated buffer on 
disk is held up in hopes that another 
sequential write request will be 
made—which, again, would be han- 
dled at memory-to-memory speed. 

Everything that I have talked about 
works very well most of the time. A 
few situations, however, create severe 
buffer conflicts requiring two or three 
times more disk I/O activity than 
would be required on a single-density 
system. The cause of this problem is 
the bottleneck created by using only 
one memory-resident I/O buffer. For 
example, many traditional batch pro- 
cessing programs are written to input 
an old master file and write an updated 
one based on maintenance transactions 
input from a third file; each time a rec- 
ord is written to the output file, the 
output host buffer must first be read 
from disk, updated with the new logi- 
cal record, then written back to disk. 
The additional I/O activity is due to 
the necessity of repeatedly writing the 
host buffer just updated back to disk to 
make room for the next incoming mas- 
ter file and transaction file record. 
This amounts to two extra I/O opera- 
tions that wouldn’t be required on a 
single-density system. 

Several methods have been used to 
alleviate this problem. One allocates 
an extra memory buffer reserved ex- 
clusively for write operations. CP/M 
Plus also uses buffer memory, almost 
as much as you can give it, to buffer 
host sectors. Even at its worst, using 
larger physical sectors will give you a 
much more responsive disk system. 

DD] 
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Varieties of Unix 


An Introductory Guide to Microcomputer Unixes 
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ow available on computers from 
N dozens of manufacturers rang- 

ing from Altos and Apple to 
Zentec and Zilog, including systems as 
small as the IBM PC and as powerful 
as the Cray supercomputer, Unix is 
well positioned to become a widely ac- 
cepted standard operating system. Ac- 
cording to a recent report issued by 
Montgomery Securities, “It is difficult 
to underestimate the importance of 
Unix to the computer industry... . In 
the business microcomputer world, 
Unix will simply become the industry's 
standard operating system. MSDOS 
will evolve to be Unix compatible and 
will be available as a subsystem under 
Unix.”! 

By the time you acquire a general un- 
derstanding of why Unix microcomput- 
ers are so attractive, you are likely to 
have discovered that there are several 
varieties of Unix, plus several “Unix- 
like’ or “‘Unix look-alike” systems. 
What are the differences between these 
systems, and do the differences make 
any difference? 


owner of the Unix trademark. True 
Unix systems are developed by pur- 
chasing a tape containing Unix source 
code from AT&T and enhancing and 
massaging the AT&T programs in ac- 
cordance with the requirements of the 
intended environment. For example, a 
user-friendly front end menu system 
might be added to shield novices from 
the possibly intimidating terseness of 
the standard Bourne shell user 
interface. 

Imitation Unix systems, such as Co- 
herent, Cromix, Idris, QNX, uNETIX, 
and UNOS, mimic Unix but do not 
contain the AT&T source code. Given 
the momentum now enjoyed by true 
Unix, the advantages, if any, of an imi- 
tation Unix ordinarily cannot compen- 
sate for the dangers involved in travel- 
ing along a nonstandard path. Of 
course, it all depends on your require- 
ments: if you are doing nothing but 
word processing, and the only Unix 
feature you care about is the Unix 
tree-like hierarchical file structure, 
and are sure you won't want to use 





There is no standard Unix. It’s not even clear exactly 
what programs are defining features in any given 
implementation. Is it possible to extract ah ypotheti- 
cal standard from the union or intersection 
of existing implementations? 





True versus Imitation Unixes 
To qualify as true Unix, an operating 
system must be licensed by AT&T, 


Alan Walworth, Fortune Systems 
Corporation, 101 Twin Dolphin Drive, 
Redwood City, CA 94065. 

Copyright © Alan Walworth 1984. All 
rights reserved. 


your computer for anything else in the 
future, then any number of operating 
systems imitating the Unix file struc- 
ture could suffice. But if you care 
about the availability of a wide selec- 
tion of software, want to stay flexible, 
and prefer to avoid unnecessary risks, 
you should stick with true Unix. 
Cromemco’s Cromix exemplifies 
some problems of look-alikes. Cro- 
memco decided to imitate partly be- 
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cause Unix licenses were very expen- 
sive at the time (the price has since 
plummeted) and partly because major 
modifications, such as translating ev- 
erything into Z80 assembly language 
and eliminatin- many capabilities, 
were needed to accommodate the limi- 
tations of an 8-bit 64K Z80 environ- 
ment. Cromemco did a good job of fit- 
ting many Unix features into that 
environment: back in 1981, when it 
was first released, Cromix was impres- 
sive. In 1984, however, powerful, new, 
low-cost hardware makes it unneces- 
sary to accept the constraints of an 8- 
bit processor with a 64K address space. 

By using Z80 assembly language 
rather than the high level C language, 
Cromemco lost a major advantage of 
Unix: efficient portability to new hard- 
ware. Thus moving Cromix to the 
68000 was a long and difficult task. 

Except for software using Unix fea- 
tures that Cromix failed to implement, 
porting Unix software to the 68000 
Cromix is feasible. The task of devel- 
oping a Cromix version, however, typi- 
cally ranks low (if it appears at all) on 
a Unix software developer’s list of pri- 
orities; the result is that a person who 
opts for Cromix can make use of only a 
small fraction of the Unix software 
available to the owner of a true Unix 
system.” (In July 1984, Cromemco ac- 
knowledged the importance of stan- 
dard Unix by unveiling new computers 
that run Unix System V.) 

Because the Unix imitations, on the 
face of it, are not in the running, and 
because an analysis sufficiently de- 
tailed to provide insight into which 
ones might be worth considering in 
which special circumstances would 
have to be quite lengthy, the look- 
alikes will not receive further attention 
here. 

A brief history of Unix will be pre- 
sented to set the stage for a discussion 
of current microcomputer Unixes. 
Stanix, a hypothetical mainstream 
bare-bones version of Unix, then will 
be described in some detail, not only to 
provide general information about 
Unix but also to illustrate what is in- 
volved in analyzing a Unix system and 
to provide a paradigm useful as a start- 
ing point for describing various Un- 
ixes. Fortune Systems’ FOR:PRO, 
Xenix, PC/IX, VENIX, System V, and 
4.2 BSD will be examined next. Al- 
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though this survey includes most of the 
main microcomputer Unixes, some 
Significant versions are regrettably 
omitted due to lack of sufficient infor- 
mation about them at the time of writ- 
ing. Vendors annoyed by inadequate 
coverage here are invited to provide 
details about their Unix implementa- 
tions to the author, so that a more com- 
prehensive survey can be provided in a 
later article.3 


A Brief History of Unix 

Unix was developed in the early 1970s 
at Bell Labs by Ken Thompson and his 
associates. From the outset, the intent 
was to create a convenient and flexible 
environment for program development. 
Contrary to the tendency at that time to 
focus on maximizing the efficiency with 
which expensive hardware could be uti- 
lized, the developers of Unix concen- 
trated their attention on efficient use of 
human resources (and, in particular, on 
efficient use of software developers’ 
time). As hardware costs plummeted 
and software development costs rose, 
the wisdom of that approach became 
increasingly apparent. 

Prior to Unix, operating systems had 
been written in assembly language, 
and Unix itself was originally written 
in assembly language for the DEC 
PDP-7 processor. In 1972, however, 
Unix was largely rewritten in C, a new 
language developed at Bell Labs by 
Dennis Ritchie, that combines low-lev- 
el power with high-level convenience 
and portability. (A small part of the 
Unix code—about 5 percent—remains 
in assembly language for the sake of 
efficiency and because of the occasion- 
al need to use a hardware function not 
accessible via C.) Although program- 
ming the operating system in a high- 
level language makes its use of the 
hardware somewhat less efficient, that 
loss in efficiency is more than offset by 
the relative ease with which the code 
can be understood, maintained, en- 
hanced, and ported to new hardware. 

The distribution of Unix was con- 
strained by federal restrictions on the 
AT&T monopoly’s participation in the 
commercial marketplace; in 1973, 
however, Unix Version 5 (not to be 
confused with System V) was released 
to educational institutions and to some 
commercial organizations. PDP-11 
minicomputers were widely used in 





universities at that time, and Unix rap- 
idly became popular as an operating 
system for those machines. 

Version 6, released in 1975, was 
made available to commercial estab- 
lishments as well as nonprofit organiza- 
tions, but the price for the commercial 
market was very high, documentation 
was minimal, and support and mainte- 
nance were not provided. 

Version 7, which appeared in 1978, 
contained enhancements including 
support of large files (up to one billion 
bytes), a standard I/O library, a more 
capable C compiler, an improved shell, 
and more sophisticated typesetting 
software. The University of California 
at Berkeley, Brian Kernighan’s alma 
mater,* ported Version 7 to its VAX 
minicomputers, and that was the con- 
figuration that was soon widely used at 
universities and other noncommercial 
institutions. 

Bill Joy and his associates at the 
Berkeley Computer Science Depart- 
ment introduced a wide variety of en- 
hancements, including the vi screen 
editor, the C shell, curses, and term- 
cap. Berkeley enhancements were 
made available to the outside world in 
the 4.1 Berkeley Software Distribution 
(4.1 BSD). A more recent Berkeley 
version of Unix, known as 4.2 BSD, of- 
fers virtual memory, networking capa- 
bilities and faster file access. 

System III, AT&T’s first serious at- 
tempt to market Unix as a product, ap- 
peared in 1981. System III contained 
features from the Programmer’s 
Workbench (PWB), which includes 
utilities such as the Source Code Con- 
trol System (SCCS), Remote Job En- 
try (RJE), and nroff and troff. 

System V, announced in 1983, is the 
version of Unix most widely used with- 
in the companies that once constituted 
AT&T and it is this version that the 
reconstituted AT&T would like to see 
accepted as a universal standard. Sys- 
tem V contains many of the 4.1 BSD 
enhancements. It features Interprocess 
Communication (IPC), which employs 
named pipes, messages, shared memo- 
ry, and semaphores. In January of 
1984, AT&T announced a new release 
of System V, V.2. 


Constant versus Variable 
Features 
One of the reasons for Unix’s populari- 
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ty is that it contains features now wide- 
ly recognized to be essential for effi- 
cient operation of a multi-user system. 
The hierarchical file structure allows 
sensible organization of data. The file 
permission system protects files from 
unauthorized access or destruction. 
The password system limits use of the 
system to legitimate users. Convenient 
background execution improves user 
productivity by making it easy to com- 
plete time-consuming data processing 
tasks without interfering with ongoing 
work. 

These basic features are explained 
in numerous introductory Unix texts, 
are fairly well known, and do not differ 
significantly from one version of Unix 
to another. Therefore, although they 
are extremely important, they will not 
be discussed further here. (For an ex- 
planation of such Unix fundamentals, 
see Understanding Unix by Groff and 
Weinberg, The Unix Operating Sys- 
tem by Christian, or The Unix Operat- 
ing System by Bourne.) 

The following sections concentrate 
on two aspects of Unix that vary far 
more from version to version and are 
much more difficult to grasp: utilities 
and system calls. It is difficult to be- 
come familiar with these areas of Unix 
due to the vastness of the territory they 
cover. A typical Unix system has hun- 
dreds of utilities and dozens of system 
calls. Mastering many utilities re- 
quires a substantial effort because of 
their complexity, and understanding 
what certain system calls do (or even 
what a system call is) requires an un- 
derstanding of internal computer oper- 
ations more advanced than that en- 
joyed by many users. 


The Utilities of Stanix 

We will examine the utilities first be- 
cause they are of primary interest to 
the majority of Unix users. The limited 
space available here makes it impossi- 
ble to explain the utilities thoroughly, 
so we will simply list the most preva- 
lent ones with a brief indication of 
what they do. The resulting checklist 
can serve as a Starting point for de- 
tailed analysis of the utilities provided 
by various versions of Unix. Our im- 
mediate objective, however, is to use 
this list as a means of revealing, in gen- 
eral terms, both the contents of the 
Unix toolkit and the extent to which 
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Pace. 
_adb* 


admin 


* 


ar 
arcv 
as 


at 
awk 


banner 
basename”* 


bc” 


| bdiff 
bfs 


cal* 
calendar 
cat” 

cb" 

cc” 

cd” 

cdc 
chgrp 
chmod* 
chown* 


| chroot 


clri 


ae 
col 


comb 


- comm* 


cp” 
cpio 
cref 


| cron 


crypt* 
csh 
csplit 


- ctags 


* 


cu 


cut 
cw 
date* 
dc* 


dcheck 
dd* 
delta 
deroff* 


a language for pattern Seg and ee sing 


searches and prints process accounting files 


general purpose interactive debugger 

creates and administers Source Code Control Sa fies csecsis isa 
set of utilities for the administration of software development or 
document development projects. SCCS enables you to keep 
track of changes made to source code or text files, including the 
date of each change, the nature of the reas who made the 
change, etc.) 

maintains archives and libraries 

converts archives to a new format CS 

assembler (all versions have assemblers, but they’ re not “al called : 

as) | 

executes a command at a speed future t time 





prints ine letters :  —es—e 

removes ‘/' and’. extensions om a Ficqare or path name ~ 

interactively processes oo peeson Pane 
expressions | : 

reports differences between two 0 bg files 

scans big files 

prints a calendar 

reminder system 

catenates (i.e., prints or lists) one or more files 

C program beautifier 

C compiler 

changes the current directory 

changes the delta commentary of a SCCS file 

assigns a file to a different user group 

changes file access permissions 

changes the ownership of a file” 


: changes the root directory for a process 
clears an inode 
compares two files 
takes reverse line feeds out of a file 
: combines SCCS deltas 
reports lines common and uncommon to two sorted files 
copies a file or set of files 
copies file archives in and out 


generates C program cross-reference listings 


| executes commands contained in /etc/crontab at predesignated 


_ times 
encrypts or decrypts a file 


‘ Berkeley’ s C shell 

context file split 

creates a function name index for a C or Fortran 77 source » file : 
: interactive system for calling another computer and transferring text 


Ss or for Shae as a 1 terminal on the called system 


prepares constant width text is ott 


displays or sets the system date and time _ 

interactively processes arbitrary-precision Wlashenuaiies 
expressions 

checks the consistency of file system directories 

converts and copies a file (e.g., to a non-Unix system) 

changes a SCCS file 

removes nroff, troff, tbl, and eqn constructs 


Table I. 
Stanix Utilities 
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a 
| diff ; 
diff3* 
diffmk 
diremp 
dump 

| dumpdir 


bee 
efi 
egrep 
expr" 
177 
factor 
| false* 
fgrep* — 
ve 
find* 
fsck 

| get 
-getopt 
gets 
graph 

| grep* 

| head © 
help” 
hyphen 
-icheck 
a 
‘init* 


_join* 
‘kill* 
Id 
tex" 
line 
lint* 
In - 
login | 
| logname 
| look 
lorder 
ipa 
ior 
ts* 
m4 
mail* 
make* 


makekey ' 


man 
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displays statistics on disk usage 
_ shows how two files differ 
_ reports differences among three files 


marks differences between files 

compares directories 

reports disk usage and file size statistics 

dumps selected parts of an object file 

prints the names of files on a dump tape 

displays arguments such as strings, filenames, shell variables, and 
command output 


_ the old standard Unix line editor, useful in shell scripts 


extended Fortran language 
searches files for matches to a full regular expression 


sets the environment for command execution 
_ formats mathematical text for nroff or troff 


Berkeley's improved version of the ed editor 

evaluates simple mathematical expressions and extracts strings 
Fortran 77 compiler 

factors a number 

returns a false value 

searches files for matches to a fixed string 


_ reports the type of a file (executable code, text, etc.) 


locates files with specified properties 

file system check with automatic repair option 

gets a version of a SCCS file 

parses command options 

suspends shell script processing to get user input 

Sets the terminal mode and baud rate during Startup 

draws a graph 

searches for a text pattern in one or more files 

displays the first lines of a file 

provides helpful information about the SCCS 

finds hyphenated words 

checks file system consistency 

prints user and group IDs and names 

sets the environment for all user programs and allows users to log 
on to the system 

produces a join of two relational data base files 

terminates designated processes 

link editor 

generates lexical analyzers 

reads a line from standard input 

reports possible problems in C programs 

makes a link to a file 

logs the current user out and logs in a new user 

gets the current login name 


_ finds lines in a sorted list 


finds the ordering relation for an object library 
displays the printer queue 
spools a file for printing on a specified printer 


removes an item from the printer queue 
displays a list of files in a directory 
a macro processor 


sends mail to other specified users 
maintains sets of related program files 
creates an encryption key 


_ displays Unix Manual pages 


Table | (cont) 


various versions of Unix are the same 
at the utility level. 

Utilities are simply programs that 
serve as useful tools. According to the 
Unix philosophy, each utility should 
perform a single task well. Power and 
productivity result from creatively 
combining the basic functions provid- 
ed by the utilities. Some tasks per- 
formed by Unix utilities, such as copy- 
ing or removing a file or logging in and 
out, are fundamental necessities for 
operating the computer. Thus, they are 
naturally regarded as part of the oper- 
ating system (by definition an operat- 
ing system is software that performs 
such fundamental functions). Tradi- 
tionally, however, many other pro- 
grams that are far less essential to op- 
eration of the computer have been 
regarded as part of the various Unix 
Operating systems. To some extent, 
this is just a result of all programs that 
AT&T decides to provide on the Unix 
release tapes becoming automatically 
part of Unix. There is no other reason 
why Fortran, for example, is consid- 
ered part of Unix and COBOL is not. 

The Stanix utilities described in Ta- 
ble I (page 26) are standard in the 
sense that each appears in at least 
three of the following six major ver- 
sions of Unix: Version 7, 4.1 BSD, Sys- 
tem III, System V.2, FOR:PRO, and 
Xenix 3.0. This selection procedure, 
although somewhat arbitrary, pro- 
duces a list of the mainstream utilities 
while winnowing out exotic commands 
like rp6fmt, vpmc.u3b, 300s, and 4014, 
which are of no importance to most 
Unix users. Of the 195 commands se- 
lected by this procedure, 92 are found 
in all six of the Unix versions; these are 
indicated in the table with asterisks. 


Stanix System Calls 
System calls are to a program what 
utilities are to the user: they are com- 
mands used by the program to tell the 
operating system to perform some basic 
action, such as opening a file for read- 
ing or creating a new process. Programs 
can also interact with the operating sys- 
tem by calling functions. The difference 
between the two methods is that the 
code for system calls is embedded in 
the operating system itself, whereas the 
code for a function must be obtained 
from outside the operating system. 

As in the case of utilities, the list of 
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Stanix system calls in Table II (page 
30) was derived by selecting those 
found in at least three of the following 
Unix systems: Version 7, 4.1 BSD, Sys- 
tem III, System V.2, FOR:PRO, and 
Xenix 3.0. As before, asterisks indicate 
inclusion in all six of these Unixes. 


Comparison of Six Major Versions 
of Unix to Stanix 

Having presented Stanix, we can now 
examine the extent to which various 
versions of Unix differ from this stan- 
dard. For each of the six major Unix 
versions— Version 7, 4.1 BSD, System 
III, System V.2, FOR:PRO, and 
Xenix—Table III (page 32) shows the 
number of Stanix and non-Stanix utili- 
ties contained in each version and the 
number of Stanix and non-Stanix sys- 
tem calls in each version. 

The figures in Table III should not 
be used as a means of evaluating these 
versions of Unix. These figures are pre- 
sented only as a method of conveying a 
general idea of the extent of these sys- 
tems, the degree to which they overlap, 
and how much they differ. Although 
much effort has been devoted to arriv- 
ing at accurate figures, inaccuracies 
are inevitable. 

A major problem in compiling such 
statistics is that available listings of 
commands and system calls either con- 
tain omissions or, as in the case of com- 
plete sets of Unix manual pages, are 
too voluminous to digest in the time 
that was available for this study. The 
Man Pages tables of contents (the 
chief source used here for Version 7, 
4.1 BSD, System III, and System V) 
fail to reference commands like egrep 
and fgrep, which are documented on 
the same man page as grep. Obvious 
omissions of this sort have been cor- 
rected, but others have probably 
slipped through.° In particular, it is 
likely that the number of additional 
system calls shown in Table III for 
these systems is misleadingly low. 

The number of additional utilities 
included is less meaningful than it 
might seem at first glance; some addi- 
tional available commands were not 
counted because they are not consid- 
ered operating system commands. 
This is especially true of FOR:PRO and 
Xenix. For example, communication 
utility programs available from AT&T 
for use on System V tend to become 
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mesg” 
mkdir* 
mkfs* 
mknod* 
mm 
mmt 
more 
mount* 
mv 
ncheck* 
newgrp* 
nice* 

nl 

nm* 
nohup 


nroff 
od* 
pack 
passwd" 
paste 


* 


pr 
prof* 
prs 
ps* 
pstat 


ptx 
pwd* 
quot 

ranlib 


ratfor* 
rc 
regcmp 
restor 
rm* 
rmdel 
rmdir 
sact 
sccsdiff 
sdb 
sdiff 
sed* 
setmnt 
sn 
shutdown 
size* 
sleep” 
sort* 
spell 
spline 
split* 
strings 
Strip* 









controls whether other users can write to your s screen . 


makes a directory 7 

constructs a file system on an unmounted device Le — 

makes a device or special file a. 

prints documents using the mm macros 

typesets documents, slides, and viewgraphs — 

displays a file one screen at a time 

mounts a file system 

moves a file or set of files | _- 

displays a table of path names and inodes for a file system 

changes your group identification  —r—“‘“—i—O™OCOCOC—~CO 

sets the priority at which a program should run 1 a 

line numbering filter -— 

displays object file symbol names 

executes a command that will ignore beybaare interrupts and will 
continue after the user logs out 

a text formatter _ 

displays a file in requested formats such as octal, hex, and Asc ies 

compresses and uncompresses files | a 

assigns or changes an account's password  —eesee 

merges the same lines of several files or successive lines of a single a 

paginates and adds an optional header 

profiles program execution 

prints the deltas of a SCCS file 

displays information about current processes . 

displays a table of system status information based on the state of - 
the kernel 

permuted index generator 

prints the working (current) directory name 

summarizes the file system ownership 

converts an archive file to a random library format that can be loaded 
efficiently _ 

rational Fortran preprocessor 

invoked by init to run during startup and shutdown 

regular expression compiler 

restores the file system incrementally 

removes a file or set of files 

removes a delta from a SCCS file 

removes a directory 

displays current SCCS editing activity 

compares two versions of a SCCS file 

symbolic debugger 

side-by-side difference program 

stream editor 

establishes a mnttab table 

the standard Bourne shell 

the normal system shutdown program 

reports object file size statistics 

suspends shell execution for a specified wienal 

sorts lines of a file by specified fields 

checks spelling 

interpolates a smooth curve 

splits a file into pieces 

locates printable strings in a binary file 

removes symbol table and relocation bits 
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| ‘troff 

: true* 

ua 
| tty 


- umask 
umount 
“uname _ 


-unget — 
| uniq* 
“units. 
update 


_uuclean 
_uucp" 


_wait* | 


| -wall* 
we’ 


what 7 


whodo — 


write* 
xargs 
yacc* 
yes 


depiays and sets terminal hatacter ete: | : 
temporarily changes your user ID so you can access restricted files 


and programs (The password must be given or the command 
will fail.) | , 

calculates a checksum for a file to detect bad blocks 

updates the super block on the hard disk and ensures that all disk 

__writes have been completed , 

sets terminal tabs 

displays the last lines of a file 

tape archive utility 

formats tables for nroff and troff 

typesetter simulator 

copies standard input data, transferred through a pipe, to a specified 
file and to the standard output (A pipe passes the output of one 
command to the input of another.) 


_ tests to see if a condition exists or if a relational expression is true or 


false 

displays time statistics for the execution of a command 

accesses a file without changing it to update its ‘‘date of latest 
access field 

manipulates a tape archive 

translates or filters specified characters 

formats text for typesetting 

returns a true value 

sets shell variables to accommodate a specific type of terminal 

sorts contents of a file based on a partial ordering of items in the file 

displays the name of the current terminal's device file 

sets the permission default mask used in file creation 

unmounts a file system 

prints the name of the Unix system being used 

reverses a get on a SCCS file 

eliminates successive duplicate lines found in a file 

measure conversion program 

periodically updates the super block on the hard disk with sync to 
minimize data loss in the event of a system crash 

cleans up the uucp spool directory 

allows sophisticated automated communication between Unix 

systems 

executes a command on a remote Unix system 

determines if a file is a SCCS file with specified characteristics 

converts lines of input using specified eh ollie and control 

statements 

a sophisticated screen editor developed at Berkeley 

Versatec printer spooler 

stops interactive shell processing until all background processes are 
completed 

broadcasts a message to all logged on users 

reports the number of characters, words, lines, and pages ina text 
file 

identifies SCCS files 

shows who is logged on 

reveals who is doing what on the system 

allows interactive communication with other logged on users 

constructs argument lists and executes commands 

yet another compiler compiler: a compiler creation system 

repeatedly displays a string or argument 


Table I (cont) 
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part of the operating system by fiat, 
but when such a utility (e.g., a VT100 
terminal emulator) is offered by For- 
tune, it is not considered part of 
FOR:PRO. 

Finally, bear in mind that in some 
cases two versions of Unix have a utili- 
ty (or system call) with the same name, 
but the functions performed, or the op- 
tions available governing just what can 
be done with the utility or system call, 
are different. 

With all their shortcomings, the 
numbers are still of interest. They 
show that the major Unix versions 
share a large body of commands that 
are essentially the same from one ver- 
sion to another. The body of shared 
utilities is sufficiently large that people 
familiar with one version will feel at 
home with another. They, however, 
may be annoyed at the lack of favorite 
utilities: programmers accustomed to 
Berkeley versions, for example, are 
likely to be disturbed when they find 
the C Shell (csh) is missing from the 
AT&T versions. 

This analysis of the extent to which 
major Unixes overlap suggests two 
guidelines for the evaluation of any 
particular version of Unix: (1) if the 
version does not contain a healthy ma- 
jority of the 195 Stanix utilities, it is, 
on the face of it, seriously incomplete, 
and (2) it is important to check to be 
sure that all the utilities you will need 
are available. Of course, novices who 
have no idea what utilities will be need- 
ed and who intend to avoid direct inter- 
action with the operating system can 
apply the second guideline only by re- 
lying on expert assistance, the recom- 
mendations of experienced users, or 
the general reputation of the product 
to establish that the system will be able 
to perform as required. 

Having gotten a feel for the extent 
to which these main versions of Unix 
differ from one another, let’s turn to a 
consideration of the noteworthy fea- 
tures of various microcomputer Un- 
ixes. FOR:PRO will be discussed at 
some length to illustrate the sort of 
customization of Unix that is needed to 
create an effective and friendly micro- 
computer operating environment. 
We’ll then look at other important mi- 
crocomputer Unixes, including some 
that could not be included in the analy- 
sis above due to lack of data. 
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ISsys 
FO RTH 


for the Apple® | 


Fixed point speed can rival that of float- 
ing point hardware. But the details have 
been a well kept secret—until now. The 
following graphs were generated by fixed 
point examples from the ISYS FORTH 
manual. 


Parallel Resonance with Damping 
BASIC 213 sec ISYS FORTH 27 sec 


a AVZe |aeye|-1aMee) oO) ae)hr-] Mm Olgels aca a lele 
BASIC 492sec ISYS FORTH 39 sec 


Fast native code compilation. Sieve 
benchmark: 33 sec 

Floating Point—single precision with 
trancendentals 

Graphics—turtle & cartesian with 70- 
oro) (Ulaavameial-|e-(ent-)mr-a 

Double Precision including D*/ 

DOS 3.3 Files read & written 
FORTH-83 with standard blocks 
Full-Screen Editor 

Formatter for word processing 

Macro Assembler 

Price: $99, no extra charges 


ILLYES SYSTEMS 
PO Box 2516, StaA 
Champaign, IL 61820 


Technical Information: 
217/359-6039, mornings 


ako) amr-lahVay-¥ 0) 0) (- Mis Man lolol-) Marts] Gare) al f-ael-) a 
Apple is a registered trademark of Apple 
(Ofolaalelenn-) a 





Circle no. 48 on reader service card. 
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FOR:PRO 

Fortune’s FOR:PRO is Version 7 Unix 
with some System III software, 4.1 
BSD enhancements, and Fortune en- 
hancements. Thus, FOR:PRO is a vari- 
ant of mainstream Berkeley Unix. Like 
System V, it contains many of the most 
desirable Berkeley enhancements. 

In addition to Berkeley enhance- 
ments, FOR:PRO contains enhance- 
ments made by Fortune. These are of 
three kinds: bug fixes, changes for im- 
proved performance, and alterations 
needed to adapt Unix to a microcom- 
puter environment. We will examine 
briefly the major changes of the last 
kind, beginning with alterations relat- 
ed to the Fortune computer’s floppy 
disk drive. 

The Unix source code provided on 
AT&T’s distribution tapes is designed 
for use on a minicomputer that em- 
ploys tape drives for backup and initial 
loading of programs. Although a tape 


access" 


backup unit is available for the For- 
tune micro, the floppy disk drive in- 
cluded with the base system has to pro- 
vide backup capability for users who 
don’t have the tape streamer; the flop- 
py drive is also normally used for new 
software installation. Thus, FOR:PRO 
needs driver software that can inter- 
face with the floppy drive. 

More interestingly, it needs a ver- 
sion of the cp (copy) command that, 
unlike the standard Unix cp, is intelli- 
gent enough to pause and suitably 
prompt the user when a new floppy 
disk needs to be inserted during back- 
up of a set of files too large to fit on a 
single disk. Similarly, when restoring a 
file system from a set of floppies, the 
Fortune cp needs to know enough to 
prompt for insertion of the next disk. A 
less essential Fortune enhancement to 
cp is the recursive option, which sim- 
plifies backup onto floppy disks by en- 
abling a single command to be used to 


reports the accessibility of a file based on its permission gee - 


the real user ID of the user 
acct” initiates records for each system process in a file, or disables the 
_ record-keeping mechanism 


alarm* causes a signal to be sent to the current process after a specified _ 
number of seconds - 
brk changes the amount of memory accessible by the current process _ 
chdir* changes the current working directory 
chmod* changes the access permission modes of a file 
chown* changes the owner and group of a file 
chroot changes the relative root directory for file identification 
close* closes a file 
creat*™ creates a new file 
dup* returns another file descriptor for a previously opened file so 5 that the a 
file can be accessed by two different file descriptors — _ 
exec” executes an executable file 
exit* terminates a process 
font provides control over open files 
fork* creates an identical twin (child) process 
fstat returns file status 
getpid* returns the process ID of the current process 
getuid” returns the real user ID of the current process 
ioctl” controls the operation of a terminal or other character device _ 
kill* sends a signal to a specified process, often resulting in termination - : - 
of that process 7 
link* assigns an additional name to a previously existing file 
lock hastens execution by virtually preventing the current process from 
being swapped out of memory 
lseek* changes the position of the read/write pointer in a file 
mknod* creates a directory or device file 
mount” mounts or unmounts a file system 
Table Il. 
Stanix System Calls 
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copy an entire file system, including 
the contents of subdirectories. 

Unix systems normally require re- 
configuration when hardware compo- 
nents such as new memory boards or 
I/O processors are added. In other 
words, the operating system must be 
told about the new hardware and re- 
constituted to take the new capabilities 
into account. Some Unix micros lack 
reconfiguration capabilities, making 
hardware additions impossible.6 On 
others, reconfiguration procedures re- 
quire expertise that new users lack. 
Fortune avoids this difficulty with 
auto-configuration: when the Fortune 
system is powered up, it automatically 
determines what hardware is in the 
system and configures itself appropri- 
ately. For users with sufficient exper- 
tise, additional facilities for fine-tun- 
ing the system will optimize 
performance based on the nature of ex- 
pected system usage. 

A third major Fortune enhancement 







_ sets the execution priority of the current process 
_. opens a file for reading, writing, or appending 
suspends execution of the current process until a signal is received 
allows two processes to communicate by creating ¢ a mutually acces- 









sible data buffer 





 tionofaC program 





eads data from a file 










current process 







processes 
gets and sets user limits 











-uname- 


_unmounts a file system 














_utime’ 





and modified 








_ terminates 
___writes data into a file 
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_ sets the process group ID 
sets the effective user or group ID of the current process 
intercepts signals for analysis, often preventing termination of the 


Table Il (cont) 


is a menu shell that enables novices to 
use applications programs and admin- 
ister the system without having any 
knowledge of Unix. Although the 
menu system is helpful for beginners, 
experienced users find it easier to work 
directly with Unix using either the 
Bourne shell or the C shell. As users 
learn more about Unix, they can easily 
switch back and forth between the 
Bourne and menu shells, letting the 
menu system assist with tasks they do 
not yet know how to perform with reg- 
ular Unix commands. 

As a rule, business microcomputer 
users are far less tolerant of operating 
system problems than engineers and 
computer scientists. For the latter sort 
of user, a system crash may be a minor 
annoyance; for the business user, it is 
more likely to be a major trauma. This 
is the case both because downtime and 
lost data can be very costly and because 
the business user typically has no idea 
what to do when something goes wrong. 


. monitors or disables the user’s program counter during the execu- 


t aces and controls a child process 


reports the attributes of a file 
_ _ Sets the system date and time 
_ writes all important memory data to disk 
returns total seconds since January 1, 1970 
returns system time consumption Statistics for the c current and child 


sets the default mask used to establish access permissions for files 


_ returns the name of the current Unix system 
unlinks a filename from a file, and if it is the last filename or 
link to the file, removes the file from the me system 
returns file system statistics 
anges the record of the latest time at which a file was accessed 


_ suspends execution of the current process until a child process 















Software 
Development 


PCDOS/MSDOS 


Complete C Compiler 
Full C per K&R 

e Inline 8087 or Assembler Floating 
Point, Auto Select of 8087 

e Full 1Mb Addressing for Code or 

Data 

Transcendental Functions 

ROMable Code 

Register Variables 

Supports Inline Assembler Code 


MSDOS 1.1/2.0 
Library Support 


All functions from K&R 
All DOS 2.0 Functions 
Auto Select of 1.1 or 2.0 
Program Chaining Using Exec 
Environment Available to Main 






















c-window™ 


Symbolic Debugger 
Source Code Display 

e Variable Display & Alteration 
Using C Expressions 

e Automatic Commands 

e Multiple Breakpoints by Function 

& Line Number 


8088/8086 Assembler 
FAST — Up to 4 times Faster than 
IBM Assembler 

¢ Standard Intel Mnemonics 

¢ Compatible with MSDOS Linker 

¢ Supports Full Memory Model 
















8088 Software Development 


et Sg Q00 


Includes: C Compiler/Library, 
c-window, and Assembler, plus 
Source Code for c-systems Print 
Utility 


c-systems 


P.O. Box 3253 
Fullerton, CA 92634 
714-637-5362 
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Two years of selling Unix systems to 
the business marketplace has given For- 
tune incentive to get the glitches out of 
its version of Unix. The result is that 
FOR:PRO is now an exceptionally ro- 
bust Unix implementation. For the 
same reason, FOR:PRO now comes 
with a set of documentation oriented to 
the needs of inexperienced users. 


Xenix 

Xenix is Microsoft’s adaptation of Unix 
System III. Like FOR:PRO, Xenix in- 
cludes ex and vi; it does not include an 
office oriented word processor compa- 
rable to Fortune’s Fortune: Word.’ For 
those wishing to adhere to the tradition- 
al Unix approach to word processing — 
an approach more suited to program 
documentation and writing scientific 
articles than to office automation— 
Xenix provides tbl for creating tables 
and eqn for representation of compli- 
cated mathematical expressions. 

Also offered are the diction and 
style programs, which search for awk- 
ward expressions, provide a measure of 
how difficult your writing is to read, 
and so on. Xenix provides a novice- 
friendly menu system called the “Visu- 
al Shell.’ Because it’s also available 
for MSDOS systems, this shell offers a 
means of providing a consistent user 
interface on all micros in an environ- 
ment containing both Unix systems 
and IBM PCs. 

In addition to uucp, Xenix includes 
Microsoft’s micnet communications 
software, a less elaborate system that 
is somewhat easier to use than uucp. 
Unlike FOR:PRO, Xenix does not pro- 
vide on-line documentation. However, 
a help facility is included in the visual 
shell. Xenix 3.0 provides utilities for 
reading and writing MSDOS files, a 
convenient feature for anyone who 
wants to run both MSDOS and Xenix 
on the same computer. 


PC/1X 

PC/IX is a fairly complete version of 
Unix System III, developed for the 
IBM PC by Interactive Systems Corp. 
of Santa Monica. PC/IX is said to be 
fast and to contain a good reconfigura- 
tion capability, but it is available only 
as a single user system and lacks some 
standard Unix utilities. The missing 
programs include fsck, pstat, ranlib, 
tar, and the C shell, csh. Although Ipr 
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is not included, a sophisticated print 
spooling utility called print is supplied 
instead. INED, a good screen editor de- 
rived from the Rand e editor, is offered 
in place of vi. 

Utilities are provided for moving 
files back and forth between PCDOS 


Version 4.1 
Seven 


Unix 
version 


System 
BSD it 


and PC/IX. No menu shell is offered. 
The troff supplied with PC/IX pro- 
duces output for only a single photo- 
typesetter, the Graphics Systems CAT. 
Compilers are available for C and For- 
tran 77; interpreters are included for 
BASIC and a version of SNOBOL. 


System — FOR: 


V PRO ~Xenix 


Number of | 
Stanix | 
utilities 

included 92 92 92 92 92 92 
that are 

in all six 

versions 


Number of 

additional 

Stank 

utilities 

included 34 oi 74 iZ 
(Total 

number of 

additional 

Stanix 

utilities : 

is 103.) 

: 
Number of : 

Stanix 

system 

calls 43 41 47 48 
included 

(Totalin — 

Stanix is | 

49.) 


Number of 

additional 15 1 10 20 
system 

calls 


Number of 
additional 16 
non-Stanix 

utilities 

included 


19” 
(41) 





49** 
(22) 


140 ow) 


47** 
(46) 


a3” 
(15) 


* This is a projected number for early 1985. The number in parentheses reflects 
what is officially available at the time of writing (August 1984). 
** This number is for the 3.0 release of Xenix. The number in parentheses reflects | 


the pre-3.0 situation. 


Table Ill. 
Comparison of Six Unix Versions 
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Development Tools That Work 


Avocet cross-assemblers are fast, reliable 
and user-proven in over 4 years of actual 
use. Ask NASA, IBM, Xerox or the 
hundreds of other organizations that use 
them. Every time you see a new micro- 
processor-based product, there’s a good 
chance it was developed with Avocet 
cross-assemblers. 


Avocet cross-assemblers are easy to use. 
They run on almost any personal com- 
puter and process assembly language for 
the most popular microprocessor families. 


Your Computer Can Be A 
Complete Development System 
Avocet has the tools you need to enter 


and assemble your soft-ware and finally 
cast it in EPROM: 


VEDIT Text Editor makes source code 
entry a snap. Full-screen editing plus a 
TECO-like command mode for advanced 
tasks. Easy installation - INSTALL pro- 
Gram supports over 40 terminals and 
personal computers. Customizable 
keyboard layout. CP/M-80, CP/M-86, 
Pao, POS. ee $150 


EPROM Programmers let you pro- 
gram, verify, compare, read, display 
EPROMS but cost less because they 
communicate through your personal 
computer or terminal. No personality 
modules! On-board intelligence provides 
menu-based setup for 34 different 
EPROMS, EEPROMS and MPUs (40-pin 
devices require socket adaptors). Self- 
contained unit with internal power supply, 
RS-232 interface, Textool ZIF socket. 
Driver software (sold separately) gives 
you access to all programmer features 
through your computer, lets you down- 
load cross-assembler output files, copy 
EPROM to disk. 


Model 7228 Advanced Programmer 
— Supports all PROM types listed. Super- 
fast “adaptive” programming algorithm 
programs 2764 in 1.1 minutes. 


Model 7128 Standard Programmer — 
Lower-cost version of 7228. Supports all 
PROM types except “A” versions of 2764 
and 27128. Standard programming algo- 
rithm programs 2764 in 6.8 minutes. 





Model 7956 and 7956-SA Gang Pro- 
grammers — Similar features to 7228, 
but program as many as 8 EPROMS at 
once. 7956-SA stand-alone version copies 
from a master EPROM. 7956 lab version 
has all features of stand-alone plus RS- 
232 interface. 

EPROM: 2758, 2716, 2732, 2732A, 2764, 2764A, 
27128, 27128A, 27256, 2508, 2516, 2532, 2564, 68764, 
68766, 5133, 5143. CMOS: 27C 16, 27C32, 27C64. 
MC6716. EEPROM: 5213. X2816A, 48016, 12816A, 


9213H. MPU (w/adaptor): 8748. 8748H, 8749, 
8749H, 8741, 8742, 8751, 8755. 


7228 Advanced Programmer $ 549 
7128 Standard Programmer 429 
7956 Laboratory Gang Programmer 1099 
7956-SA Stand-Alone Gang Programmer 879 
PD Driver Software 95 
481 8748 Family Socket Adaptor 98 
511 8751 Socket Adaptor 174 
755 8755 Socket Adaptor 135 


CABLE RS-232 Cable (specify gender) 30 


HEXTRAN Universal HEX File Con- 
verter — Convert assembler output to 
other formats for downloading to de- 
velopment systems and target boards. 
Also useful for examining object file, 
changing load addresses, extracting parts 
of files. Converts to and from Intel, 
Motorola, MOS, RCA, Fairchild, Tek- 


tronix, Tl, Binary and HEX/ASCII Dump 


formats. For CP/M, CP/M-86, MSDOS, 
Pa a geo a eae $250 
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Would you hire an entire band when 
all you need is one instrument? Of 
course not. 


So why use a whole orchestra of 
computers when all you need is one 
to develop software for virtually any 
type of micro-processor? 


The secret? Avocet’s family of 
cross-assemblers. With Avocet 
cross-assemblers you can develop 
software for practically every kind of 
processor — without having to 
switch to another development 
system along the way! 





AVOCET’S SUPERB 68000 CROSS- 
ASSEMBLER — With exhaustive field 
testing completed, our 68000 assembler 
is available for immediate shipment. 
XMAC68K supports Motorola standard 
assembly language for ‘the 68000 and 
68010. Macros, cross-reference, struc- 
tured assembly statements, instruction 
optimization and more. Linker and 
librarian included. Comprehensive, well- 
written manual. XMAC682 for MK68200 
has similar features. 


Call us toll-free for some straight talk 
about development systems. 


1-800-448-8500 


(in the U.S. Except Alaska and Hawaii) 


VISA and Mastercard accepted. All popular disc formats now available 
--please specify. Prices do not include shipping and handling -- call for exact 


quotes. OEM INQUIRIES INVITED. 


**Trademark of Microsoft 


*Trademark of Digital Research 
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DOVER, DELAWARE 19901 
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VENIX 

VenturCom’s VENIX is an IBM PC im- 
plementation of Version 7 Unix with 
Berkeley enhancements, including vi 
and the C shell. Unlike PC/IX, VENIX 
can handle up to three simultaneous 
users. Awk, lex, and yacc are included, 
but lex is apparently incomplete.® 
Troff is absent. Simple graphics func- 
tions are provided for tasks such as 
drawing lines and circles. On-line ref- 
erence materials, available on full- 
blown Unix systems via the man com- 
mand, are not included in VENIX. A 
BASIC interpreter is provided. Sema- 
phores are available for interprocess 
communication, a step in the direction 
of System V’s IPC capability. The Fi- 
nal Word is supplied as an optional 
word processing alternative. Of special 
interest to people dreaming of portable 
Unix systems is the plan (perhaps a re- 
ality by the time this is published) to 
offer a version of VENIX as an option 
on Data General’s new 10-pound PC. 


































System V 

In addition to bug fixes and perfor- 
mance enhancements, System V con- 
tains a variety of changes from System 
III. Improved file I/O performance 
may be noticeable due to a doubling of 
the block size to 1024 bytes.? An im- 
proved scheme of file system updates 
reduces the risk of file corruption in 
the event of a system crash. 

From a software developer’s view- 
point, the most interesting improve- 
ment is System V’s new Interprocess 
Communication (IPC) capability, 
which utilizes messages, shared memo- 
ry, semaphores, and named pipes. The 
message capability allows a process to 
directly and efficiently communicate 
with another process. Shared memory 
is memory available to more than one 
process. Semaphores are used to coor- 
dinate access to shared memory by the 
multiple processes using it.'!° Named 
pipes, like ordinary pipes, channel data 
from one process to another. The dif- 
ference is that an ordinary pipe re- 
quires the two processes to be concur- 
rent; with a named pipe, output from a 
current process can serve as input toa 
process that does not yet exist. An IPC 
remove command is available to clear 
out unwanted message queues and 
semaphore identifiers. A new file sys- 
tem checker, dfsck, allows multiple file 
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systems to be checked simultaneously. 

The C programming environment 
has been altered in several respects, in- 
cluding a new Common Object File 
Format (COFF), enhancements to the 
math library, and cflow, a new pro- 
gram for flow analysis that generates 
module-calling hierarchy charts. An 
annoying deficiency of the System V C 
compiler is that it allows variable 
names to be only eight characters long 
(a limitation shared by many older C 
compilers). The improved symbolic de- 
bugger, sdb, can be used for both C 
and Fortran 77 programs. 

The —ms macros, used by the nroff 
text formatter, have been eliminated. 


4.2 BSD 

4.2 BSD, the latest release of Unix from 
Berkeley, offers virtual memory, ad- 
vanced networking capabilities based 
on “sockets,” enhancements for fast file 
access, and the ability to use filenames 
much longer than the 14-character 
maximum on most Unixes. 4.2 BSD 1s 
the Unix of choice for engineers using 
relatively large and powerful systems 
such as superminis; it is less suitable for 
ordinary micros. Systems built around 
the 68000 processor, for example, lack 
the hardware required for effective vir- 
tual memory implementation (the 
68010 overcomes this lack). Also, 4.2 
BSD is relatively large, which interferes 
with efficient performance on a micro 
with limited memory. As micros be- 
come more powerful, these problems 
will become less significant. 


The Future of Unix 

AT&T is making a major effort to es- 
tablish System V as the standard. But 
just as 4.2 BSD lacks some of System 
V’s capabilities, System V lacks some 
important 4.2 BSD features. To some 
extent, we can expect the best features 
of both 4.2 BSD and System V to be 
incorporated into future Unix versions. 
The catch is that there is a limit to how 
many 4.2 BSD features can be grafted 
onto System V; addition of System V 
features to 4.2 BSD is far less problem- 
atic. Much depends on what IBM does, 
and strategists there must be tempted 
to thwart AT&T by promoting Unixes 
other than System V. (It is rumored 
that IBM is considering making 4.2 
BSD available for use under VM.!!) So 
the extent to which System V will be 





accepted as a standard remains in 
doubt. 
_ Spending megabucks on advertising 
does not guarantee acceptance of a 
proposed standard. Micro Unix ver- 
sions based on Version 7 and System 
III, such as Xenix, PC/IX, VENIX, and 
FOR:PRO, are in use at far more sites 
than System V. According to the Su- 
permicro newsletter, “with the Xenix 
announcement for the AT, IBM has 
administered a possibly fatal blow to 
AT&T’s expensive effort to establish 
System V as a standard.”!” 

Jean Yates of Yates Ventures was 
quoted in September as saying, “With- 
in 18 months AT&T will be conforming 
to the IBM standard—Xenix.”!3 Micro 
columnist John Dvorak recently sug- 
gested that “AT&T is not only losing 
key personnel but also may lose the 
System III vs. System V battle... 
The failure of AT&T to add record 
locking and virtual memory to System 
V ... may mean that AT&T will lose 
control of the direction Unix will 
tae." 

It should be pointed out that AT&T is 
aware of System V’s deficiencies and is 
working to overcome them. In a talk 
given in April 1984 at the European 
Unix User Group (EUUG) conference 
at the University of Nijmegen in Hol- 
land, Bell Labs’ Larry Crume indicated 
that demand paging will be incorporat- 
ed into AT&T’s kernel as a configura- 
tion option in the near future. 

The record-locking issue merits spe- 
cial attention because lack of record 
locking has often been mentioned as a 
weakness of Unix. To be sure, until re- 
cently there was no official Unix stan- 
dard record-locking mechanism, and 
some Unix systems still don’t offer re- 
cord locking. But Unix systems aimed 
at the business marketplace, such as 
FOR:PRO, VENIX, and Xenix, must of- 
fer record locking because it’s needed 
for efficient shared data base applica- 
tions such as multi-user accounting 
systems. 

The record-locking scheme devel- 
oped by John Bass'> is the de facto stan- 
dard and, as of the summer of 1984, 
is an official standard adopted by the 
/usr/group Standards Committee.'° In 
the original version developed for Onyx 
in 1981 and now in the public domain, 
the key system call is named locking. A 
more recent implementation calls the 
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key system call lockf. The lockf version 
is essentially the same as locking but 
provides enhancements such as the abil- 
ity to test whether a region is locked 
without at the same time locking it. 
This record-locking scheme is effective 
and widely used, and AT&T has indi- 
cated it will cooperate with the 
/usr/group Standards Committee’s 
adoption of it as a standard. 


Choosing a Unix 

Given the vast variety of Unix versions, 

which should you select if you are 

choosing a Unix system? Depending 

on your circumstances, you should 

consider not just what is contained in a 

given version of Unix but such aspects 

as: 

¢ The likely enhancements in future 
releases of the version 

¢ How fast the version runs 

¢ How bug-free it is 

¢ The quality of available 

documentation 

The quality of the hardware that the 

Unix version runs on 

e Availability of support 

¢ The range of software that runs on 
the version (in particular, whether 
all the application software you need 
is currently running in a reasonably 
well-debugged state on the system) 

e Price 
Don’t decide you need System V just 

because AT&T has spent so much time 

and money advertising it. On the other 

hand, take all the talk about the failure 

of AT&T to make System V the stan- 

dard with a grain of salt. As noted ear- 

lier, System V’s deficiencies are being 

remedied. System V IPC capabilities 

provide an effective foundation for in- 

tegrated application software, this in- 

herent strength, as well as AT&T's 

marketing effort, will result in continu- 
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ing integration of System V features, if 
not true System V, into new micro- 
computer products. Pundits who pro- 
claim that Xenix on the AT will blow 
System V out of the water ought to 
give some serious attention to Micro- 
soft’s efforts to produce a new version 
of Xenix based on System V. Although 
currently (August 1984) little if any 
commercially available software 
makes use of the new System V capa- 
bilities, a large quantity of high-quali- 
ty System V software is likely to be on 
the market soon. 

If the availability of the forthcoming 
System V software is important to you, 
bear in mind the possibility of avoiding 
current System V shortcomings by 
choosing a Unix that is not certified 
System V but that offers, or in future 
releases will offer, System V compati- 
bility. Some microcomputer vendors 
who advertise System V in reality offer 
System V features grafted onto anoth- 
er version of Unix, rather than true 
System V. If it turns out that what is 
being offered is indeed real System V, 
be sure to check performance, reliabil- 
ity, and availability of adequate appli- 
cation software before you buy. Of 
course, these things ought to be 
checked before purchasing any other 
version of Unix, too. The special dan- 
ger posed by AT&T's System V—and 
by IBM’s products—is that massive 
marketing efforts, plus the magic of 
three familiar letters, may lead people 
to make purchasing decisions without 
being sufficiently careful to make sure 
that what they are getting satisfies 
their requirements. 


Notes 

| This report, titled “The Meaning of 
Unix,” can be obtained by contact- 
ing Bill Shattuck at Montgomery 


Securities (415) 627-2572. 

2 Note, however, that as of August 
1984 System V Unix is an excep- 
tional case; there is currently little 
application software for System V 
computers. 

Information should be sent to Alan 
Walworth, 825 Clara, Palo Alto, 
CA 94303. Ideally, I would like man 
pages so that I can provide a de- 
tailed picture of a wide variety of 
Unix systems. Although ordinary 
sales literature is better than noth- 
ing, it is insufficient for in-depth 
analysis. 

Brian Kernighan, coauthor with 
Dennis Ritchie of the key reference 
work The C Programming Lan- 
guage, was an early participant in 
Unix development at Bell Labs. 
Kernighan coined the term “Unix.” 
Note that, even if all these problems 
were taken care of, there would still 
be a similar problem with options, 
since you need to know all the op- 
tions to grasp the full range of issu- 
able commands. To see this point 
clearly consider that egrep and fgrep 
could have been implemented as op- 
tions provided with grep (grep -e 
and grep -f). Such an implementa- 
tion would have two fewer com- 
mands but no less functionality. So a 
comprehensive analysis of the capa- 
bilities of various Unix versions 
would require an investigation of 
just what command options, as well 
as just what commands, each 
provides. 

6 Gene Dronek, ‘“‘PCIX,’> UNIX/ 
WORLD, March/April 1984, p. 37. 
However, office-oriented word pro- 
cessing may exist for machines run- 
ning Xenix. Microsoft and manu- 
facturers of hardware on which 
Xenix runs should be able to provide 
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information about what is available. 
According to Mark S. Zachmann, 
lex “is missing one of its object li- 
braries.”” This statement appears in 
his article “A Venerable UNIX,” in 
PC, vol. 3, no. 11, June 12, 1984, pp. 
246 — 248. 

FOR:PRO also uses a 1024-byte 
block size. Using a large block size 
has both pros and cons: to take a 
simple example, if there are a thou- 
sand files, each 400 bytes long, using 
up a 1024-byte block for each one 
wastes a lot more disk space than us- 
ing up a 512-byte block for each 
(roughly 1000 times 600, or 600,000 
bytes wasted versus about 100,000 
bytes). 4.2 BSD overcomes this 
drawback by using blocks 4096 
bytes long for most files but arrang- 
ing, when suitable, to let several 
small files share a single 4K block. 
The trade-off is that this and other 
file system optimization techniques 
add considerably to the size of 4.2 
BSD. 

For a good introductory discussion 
of semaphores, see Operating Sys- 
tem Design: The XINU Approach by 
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Douglas Comer (Prentice Hall, 
1984). 

Sol Libes, ‘““News and Views,” Mi- 
crosystems, September 1984, p. 8. 
Supermicro, August 31, 1984 (pub- 
lished by ITOM International Co., 
P.O. Box 1415, Los Altos, CA 
94022). 

Jean Yates, Fortune, September 17, 
1984, p. 70. 

John Dvorak, InfoWorld, Septem- 
ber 10, 1984, p. 96. 

John Bass, a Unix expert who assist- 
ed with development of Fortune’s 
FOR:PRO, is currently a consultant 
with DMS Design. 

The /usr/group standards are pub- 
lished as a document titled Proposed 
Standard: 1984 /usr/group Stan- 
dard, available from /usr/group, 
4655 Old Ironsides Drive, Suite 200, 
Santa Clara, CA 95050. The Re- 
viewer's Guide to the Proposed /usr/ 
group Standard, which is available 
with the Proposed Standard, in- 
cludes a listing showing which sys- 
tem calls and subroutines are provid- 
ed in the /usr/group standard, 
System V, System III, Version 7, and 
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4.1 BSD. It also contains some useful 
background information, an explana- 
tion by John Bass of the lockf record- 
locking standard, and a report by D. 
Cragun and D. Kretsch of Bell Labs 
on the ways System V differs from 
the /usr/group standard. Cragun 
and Kretsch start off with a peculiar 
piece of reasoning that suggests 
AT&T is not wholly enthusiastic 
about the /usr/group standard: “The 
current membership of the /usr/ 
group Standards Committee repre- 
sent end users of Unix systems, devel- 
opers of Unix systems, developers of 
systems that are based on or look like 
Unix systems, and applications de- 
velopers. Therefore, the /usr/group 
standard is not a Unix system stan- 
dard.” /usr/group also publishes a 
Unix Software Catalog, a new edi- 
tion of which is due out in early 1985; 
this could be a useful starting point 
for obtaining information on micro- 
computer Unixes omitted from this 
article. DD} 
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Unix 
Device Drivers 


by John L. Bass 


Some Unix systems currently being 
shipped use disk queuing algorithms that 
optimize throughput. Their performance 

looks less attractive when you realize 
that the best-throughput algorithms yield 
the worst values for response time 

and fairness. 


tem and Unix device drivers. The concepts herein cov- 

er a wide range of Unix operating systems as well as a 
number of non-Unix systems. Unix Version 7 drivers are the 
baseline for the information in this discussion. Device drivers 
in both earlier and later versions of Unix are similar in con- 
cept to these Version 7 drivers but have different system 
interfaces, queuing structures, and control flow. 

For more information on Unix, see The Bell System Tech- 
nical Journal, Part 2, July — August 1978, vol. 57, no. 6. See 
also ““The Unix I/O System” by Dennis M. Ritchie, found in 
the Unix Programmer's Manual, seventh edition, vol. 2B, 
and in other documents for various releases of Unix. 


T his article is an introduction to the Unix I/O subsys- 


A Unix I/O Subsystem Overview 

Before we look at Unix drivers, we need to take an overview 
of the Unix kernel to understand the overall system control 
flow. Shown in Figure | (page 40) is the block structure of 
the Unix I/O system—from a functional view. Each rectan- 
gular block in the diagram implements a certain function- 
ality in a modular fashion. Communication between blocks 
is accomplished via subroutine calls and data structures 
passed as arguments in those calls. Each rectangular block 
with rounded corners represents a switch table structure 
used to select one of several similar functions. 


The System Call Interface and Switch 

System and application processes interface to the I/O sub- 
system via the library subroutines open, close, read, write, 
ioctl, and Iseek. Each of these library subroutines copies its 
arguments according to system call conventions, sets the sys- 
tem call number, and then causes a hardware/software call 
to the system call manager. This procedure varies from sys- 
tem to system. 

The system call manager copies the arguments out of the 
process’ memory and into the kernel’s memory. It then uses 
the system call number to index into the system call switch 
table (a jump table) to find the proper kernel subroutine to 
call. The arguments are assembled for the routine, and the 
routine is called. 

When the routine returns, the system call manager copies 
the return status into the process’ memory and resumes exe- 
cution of the process. 


John Bass, 6946 Blue Hill Drive, San Jose, CA 95129. 
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The File 1/O Subsystem 

The file I/O subsystem has entry points in the system call 
switch table for each file [/O system call. The following are 
the basic entry points used by applications: 


If the inode references a block special file, then the 
current file pointer offset is translated into a logical block 
number for the device. 

If the inode references a file or directory, the current 
file pointer offset is translated into a logical block in the 
file. The allocation information for the file is then used to 
locate the logical block number on the device. 

The block I/O subsystem is then requested to return a 
system buffer with the device data. If it is a read system 
call, then the data in the buffer is copied into the applica- 


Open: scans the directory structure to locate the file named 
by the application. The inode for the file is brought into 
memory for use by the other system calls. The inode de- 
scribes all of the file type, ownership, and allocation infor- 
mation for a file. 


If the inode describes a character or block special file, 
then the driver must be passed the open call. The major 
device number in the inode is used as an index into either 


tions buffer. If it is a write system call, then the data in 
the applications buffer is copied into the system buffer, 
and the buffer is flagged to be written back to the device. 


the block or character device driver switch table to obtain 
the driver’s open routine address. If no driver open routine 
address is found in the switch table, then the driver does 
not require an open call. If an address is found, then the 
open routine is called. 

If an error occurred, then an error status is returned: 
otherwise, a file descriptor is returned to the application 
process. 

Close: If the inode is for either a character or block special 
file and no other process has the inode open; then the close 
routine (if any) in the switch table is found and the driv- 
er’s close routine is called. 

Read and Write: If the inode references a character special 
file, then the character device driver switch is used to call 
the driver’s read or write routine. When the routine fin- 
ishes, the return status is passed back to the application 


process. 
4 if 


This process is repeated for as much data as was re- 
quested by the applications system call. 
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Lseek: This system call does not cause any I/O action to be 
performed. It simply changes the current file pointer off- 
set used by the read and write routines. 

Ioctl: If the inode does not reference a character special file, 
then an error status is returned; otherwise, the ioctl rou- 
tine in the device driver is called. 


The Block I/O Subsystem 

The block I/O subsystem maintains an in-memory buffer 
pool that forms a simple FIFO cache of blocks read or written. 
Requested blocks are returned immediately when they are 
found in the pool. If these blocks are not found in the pool, 
then the oldest buffer is freed, allocated for this device /block, 
and then passed to the proper device driver strategy routine. 


The Process and Swap Scheduler 

The system swapper uses a special buffer descriptor to build a 
swap in or swap out I/O request. The swapper then calls the 
device driver’s strategy routine with the buffer descriptor to 
process the request. Normally, large swaps are done in a num- 
ber of 10K to 60K chunks to minimize hogging of the device. 


The Block Device Driver Switch 

The switch table is an array of structures indexed by the 
block major device number. This structure contains the ad- 
dresses for the device driver’s Bopen, Bclose, and Bstrategy 


Process 0 Process nn Process mm ~ Other Processes : . | a : 
Init Shell | user cond -— 
Systeme Cal! Interface and Switch 
Fite 1/0 Subsystem 


TTY Discipline 
{ane of several) 


Line Discipline Character Device 
Switch Driver Switch 






subroutines. It also contains the address of the device’s I/O 
queue for use by system metrics. Device drivers are not re- 
quired to have a Bopen or Bclose routine. When they do not, 
the entry point for a null subroutine is placed in the table for 
the missing subroutine. 

Each block device driver will have one or more entries in 
this table. The entries are created during system generation 
or, on some systems, during autoconfiguration when the sys- 
tem is started up. 


The Character Device Driver Switch 

The switch table is an array of structures indexed by charac- 
ter major device number. This structure contains the ad- 
dresses for the device driver’s Copen, Cclose, Cread, Cwrite, 
Cioctl, and Cstop subroutines. Also often included is a point- 
er to the first TTY structure controlled by the driver for use 
with system metrics. Device drivers are not required to have 
a Copen, Cclose, Cioctl, or Cstop subroutine. As with the 
block device, the address of a null routine is placed in the 
table. For a device that does not have a read routine (write 
only—e.g., something like a printer) or does not have a write 
routine (read only device—a paper tape reader), it is advis- 
able to cause the missing function to return an error. For 
these devices, the table contains the address of a routine that 
returns an error. 









Driver Switch 


Figure 1 


UNIX Functional Structure 
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The Block Device Driver 

A generic disk driver represents the general form of most 
block device drivers. The structure of a disk driver is given in 
Figure 2 (page 41). 

The block device drivers are used mainly by the file I/O 
subsystem and block I/O subsystem to provide buffered ac- 
cess to file system devices. In practical terms, these ‘“‘de- 
vices” can be disk drive devices of all kinds, disk emulators 
(for instance, a RAM disk), and sometimes a network-pro- 
vided remote disk service. 








Block and Character Switch Tabies 


State Structure and Queues for Device and Driver 


Hardware/Soltware Interface 
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Most block device drivers also have a simple character 
driver interface as well. This interface allows direct multi- 
block transfer to and from the device without using system 
buffers. This process is mainly used by file system mainte- 
nance utilities. The character driver interface also allows the 
driver to use ioctl calls for special applications (for example, 
a Format Diskette command). 


The Character Device Driver 
Character device drivers are used to interface all types of 
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Disk Device Driver 
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devices to Unix. The driver interfaces the external device to 
open, read, write, and close system calls to maintain the de- 
vice-independent I/O model. 

An important specialized form of character device driver 
exists for communication devices that interface terminals to 
the system. All the special processing to handle echo, charac- 
ter erase, line erase, end of file, xon/xoff flow control, and 
signal generation is contained in the default tty line disci- 
pline. The line discipline switch is an interface to link the 
default tty line discipline into the terminal driver as well as 
provide for alternate tty protocols and special tty handling. 

Much of the difference between Version 7, Berkeley re- 
leases, System 3, and System 5 revolves around changes and 
improvements in the tty line disciplines. There are signifi- 
cant differences between the implementations for each of 
these releases. 

Figure 3 (page 46) shows the basic outline for a simple 
terminal driver. This driver completely defaults to using only 
the default tty line discipline. In practice, a fully implement- 
ed driver is much more complex. 


The Block Device Driver 

This section will discuss the generic disk driver in more de- 
tail (see Figure 2). Simple algorithms will be presented for 
each major routine found in the basic disk driver. The out- 
lines provided here are simplified to some extent. The details 
vary slightly between various versions of Unix. If you have 
access to a driver source for your system, consult those list- 
ings for more details. 


Subroutines Bopen and Copen 

The basic function of an open routine is to provide initializa- 
tion for the controller and drive. Both the block and charac- 
ter open routines may be active at the same time if a sleep is 
done during initialization of the controller or drive. Like- 
wise, it is possible to have a concurrent close on one interface 
and an open on the other. Thus, if either open or close sleeps 
on some I/O, it may be necessary to set some semaphore to 
prevent race conditions during opens and closes. 

There are separate open routines in both the block and 
character interfaces. To be certain that no minor device is 
open, the routine must check that no block minor device is 
open and that no character minor device is open. To forget 
this is a common mistake: it results in the controller /driver 
getting initialized while active I/O is in progress. 

The open routine is called for each open system call for the 
minor device. The kernel should call open for the root, pipe 
and swap devices ... but this is sometimes overlooked or 
difficult to do. 

Begin subroutine open(minor_device) 

While open_close_lock set, sleep on open_close_lock 
Set open_close_lock 
If no minor device on this controller is open, then 
Initialize the controller 
Mark controller as ready 
End if 
If no minor device on this drive is open, then 
Initialize the drive 
Mark drive as ready 
End if 


42 


Mark minor_device as open 
Free open_close_lock 
End subroutine open 


Subroutines Bclose and Cclose 
This is simply the reverse problem from open with the addi- 
tional task of flushing and waiting for outstanding buffered 
writes. 
Begin subroutine close(minor_device) 
While open_close_lock set, sleep on open_close_lock 
Set open_close_lock 
If any buffered writes for this minor_device, then 
Flag and queue all buffers found 
Wait for minor_devices queue to become empty 
End if 
Clear minor_device open flag 
If no minor device on this drive open, then 
Take drive off line (if required) 
Release drive from controller 
End if 
If no minor device on this controller open, then 
Release controller 
Flag controller as idle 
End if 
Free open_close_lock 
End subroutine close 


Subroutine Cioctl 
Most disk drivers do not have an ioctl interface. In those that 
do, the most common use of the interface is to provide a 
means for formatting floppy disks (or other removable 
media). 
Begin subroutine cioctl(minor_device, cmd) 
If user is not root or cmd is not format, then 
Return error status 
End if 
While raw_buffer is busy, sleep 
Mark raw_buffer as busy 
Set up command parameters in raw_buffer 
Set command type to format 
Call strategy to queue I/O request 
While raw_buffer is not done, sleep 
Mark raw_buffer as free 
End subroutine cioctl 


Subroutine Cread 
The normal raw disk read function simply calls physio to vali- 
date the user’s request, acquire the buffer, initialize the buffer 
parameters, queue the request, and monitor the I/O 
completion. 

Begin subroutine cread(minor_device) 

Call physio to build raw read request for strategy 
End subroutine cread 


Subroutine Cwrite 
The normal raw write request is just like the read request. 
Begin subroutine cwrite 


Call physio to build raw write request for strategy 
End subroutine cwrite 
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System Function Physio 

The system function physio does all the normal handling to 
set up a dma transfer to/from an applications buffer. This 
includes validation of the addresses and lengths requested by 
the application. The physical addresses are calculated and 
plugged into the provided buffer header. Physio then calls 
the provided strategy routine and waits for I/O to be com- 
pleted. Any error processing is done, and the resulting status 
is returned to the application. 


Subroutine Bstrategy 
The strategy routine’s job is to take the requested buffer 
header, map it to the correct device and physical block, and 
enter it into the queue. 
Begin subroutine strategy(buf) 
If the requested I/O is outside this partition, then 
Set error flags 
Mark buffer as done 
Return to caller 
End if 
Map correct device and block number from buffer 
parameters using partition table, dkunit, and 
dkblock 
Map block number into cylinder group 
Call dksort to sort request into proper place in queue 
Call Dstart if the device is idle 
End subroutine strategy 


System Functions Dkunit, Dkblock, and Dksort 
These system functions are used to implement system stan- 
dard device interleaving and request queue sorting. 

The device interleaving is used to interleave a logical par- 
tition over two or more physical drives to balance I/O re- 
quest loading on the drives. A secondary use of this function 
is to combine two drives into a larger, single logical partition. 

The request queue sorting is used to provide a standard 
queue optimization. The standard algorithm used is up-ele- 
vator (C-Scan) with read preference. This algorithm gives 
better I/O throughput than FIFO, but allows significant un- 
fairness to be introduced between multiple disk-bound pro- 
cesses. Although this is a good general algorithm, other algo- 
rithms produce fairer access to the disk and less erratic 
response times, while only reducing the total disk throughput 
by a small margin. 


Subroutine Dstart 
The purpose of this routine is to translate the parameters in 
the buffer header into command parameters for the disk con- 
troller. The I/O request is then started by the controller. 
When the request is done, the hardware generates an inter- 
rupt, which then calls the Dinterrupt routine. The interrupt 
routine processes the completion or retry of the last request 
and calls start to get the disk controller going again. 
Begin subroutine start 
If request queue is empty, then 
Return 
End if 
Mark device as busy 
If buffer is raw__buffer and command is format, then 
Build format command 


aah 


Start format operation 
Return 
End if 
Build transfer command 
Start transfer operation 
Update metrics 
End subroutine start 


Subroutine Dinterrupt 
The interrupt first checks for error on the transfer. If an 
error is found and there have not been too many retries, then 
the last request is restarted or marked as a hard error. 
If the transfer was correct, then the buffer is marked done 
and start is called for the next request. 
Begin subroutine interrupt 
If device was idle, then 
Log false interrupt if necessary 
Return 
End if 
If a device error, then 
If a soft error and only a few retries, then 
Clear error condition, if necessary 
Restart controller 
Return 
End if 
Flag error for request 
End if 
Mark request as done 
If more requests in queue, call start 
End subroutine interrupt 


The Simple Serial Terminal Driver 

The basic form of a single line terminal driver is shown in 
Figure 3 (page 46). This driver is the minimal form for a 
single-character-at-a-time UART with interrupts handled in 
C code. In practice the Version 7 drivers are significantly 
more complex, particularly after performance optimization 
using software pseudo-dma. System 3 and System 5 drivers 
have additional complexity because device-specific output 
processing from the tty generic routines is transferred to the 
driver. It can be expected that even later versions will continue 
this trend to better support remote network terminals, multi- 
windowed terminals, and bit-mapped graphics terminals. 


Subroutine Copen 
Begin subroutine copen(minor_dev) 
If not a legal minor_device, then 
Post an error 
Return 
End if 
Initialize tty queuing /state structure 
If first open on device, then 
Set open flag 
Set default initial state flags 
Call system function ttychars for initialization 
End if 
Initialize hardware interface and interrupts 
Call system function ttyopen with queuing structure to 
complete open sequence 
End subroutine 
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System Function Ttyopen Call system function ttyclose with queuing structure 
The ttyopen function does system-specific initialization that is End subroutine 

common to all terminal drivers. This function generally in- 

cludes establishing terminal ownership, process groups, and | System Function Ttyclose 


marking the queuing structure as open. The ttyclose function performs the common close processing 

for terminal devices. This generally involves disassociating 

Subroutine Cclose the device from any process group, waiting for characters in 

Begin subroutine cclose the output queue to finish transmitting, clearing the input 
Acquire queuing structure for this minor device queues, and marking the queue as closed. 






Character Driver Switch Table 









_— State Structure and Queues for Device and Driver 


_-Tinterrupt 






| Hardware Interrupt / 








Hardware/Sofiware Interface 






Figure 3 
Simple Terminal Device Driver 
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Subroutine Cioctl 
Begin subroutine cioctl(minor_device, cmd) 
Acquire queuing structure for this device 
Call system function ttioccom with queuing structure 
and cmd arguments 
If hardware parameters have changed for device, then 
Reprogram hardware to conform to new 
parameters 
End if 
End subroutine 


System Function Ttioccom 

The ttioccom function performs the common processing to 
handle terminal ioctls reading and editing the hardware and 
software state variables for a serial port. 


Subroutine Cread 
Begin subroutine cread 
Acquire queuing structure for this minor device 
Call system function ttread with the queuing structure 
End subroutine cread 


System Function Ttread 

The ttread function calls other routines to process the raw 
characters on the input queue. Any required editing is done, 
and the resulting input data is copied into the applications 
buffer. If more data is required and the input queue is empty, 
the routine sleeps while waiting for input. 


Subroutine Cwrite 
Begin subroutine cwrite 
Acquire queuing structure for this minor device 
Call system function ttwrite with queueing structure 
End subroutine cwrite 


System Function Ttwrite 

The ttwrite function calls other routines to process the out- 
going data. Terminal-specific handling is done for tabs, new 
lines, upper-case and lower-case characters, and delay pro- 
cessing. The routine sleeps as required on the output queue, 
copies data from the applications buffer to the output queue, 
and calls the start routine to keep the device busy. 


Subroutine Cstart 
Begin subroutine cstart 
If hardware is not ready, then 
Return 
End if 
If a character is on output queue, then 
Remove character from queue 
If the character is data, then 
Send the character out the serial line 
Else 
Do delay processing 
End if 
End if 
End subroutine cstart 


System Function Hardware Interrupt 
By some hardware and/or software means the communica- 
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tions device presents an interrupt request to the system. Often 
special processing is required to save the hardware/software 
state at the time of the interrupt. After this state is saved, the 
proper driver interrupt processing routine is called. 


Subroutine Tinterrupt 
Begin subroutine tinterrupt 
Acquire queuing structure for device 
Call system function ttstart to do any special handling 
and then call driver’s cstart routine 
If the output queue has enough free space, then 
Wake up any sleeping applications to fill it up 
End if 
End subroutine 


System Function Ttstart 

The ttstart function does common processing before calling 
the device’s start routine. The function generally includes 
checks to prevent starting a line that is stopped for some 
reason or is already busy. 


Subroutine Rinterrupt 
Begin subroutine rinterrupt 
Acquire queuing structure for device 
If there is data in receiver, then 
Get character from serial receiver 
Call system function ttyinput to process character 
End if 
Reset interrupt enable as required 
End subroutine 


System Function Ttyinput 

The ttyinput function handles common processing of input 
characters at interrupt time. This generally includes queuing 
character echo, handling xon/xoff flow control, signals, end 
of file, and converting input case. The input is queued for 
edit processing by ttread. A wakeup of ttread is done as 
required—either on a special condition or on every character 
if in raw or cbreak mode. 


Background 

There are many pitfalls for device driver writers. To explore 
them in reasonable detail would require a three- to four-day 
seminar. Two interesting problems are common “‘mis’-fea- 
tures in many Unix systems currently being shipped. 


Better Dsort Algorithms 

To evaluate various candidate algorithms, readers must first 
abandon prior knowledge of what is best and then take a 
good look at the Unix environment and applications. 

(1) A large number of studies have been done on disk queu- 
ing strategies for batch environments to optimize through- 
put. Response time and fairness are not addressed as key 
variables in those studies. Unfortunately, the optimal solu- 
tions for throughput have the worst response time and fair- 
ness qualities. Computer scientists as a whole tend not to 
reevaluate old trade-offs in the face of new requirements. 
The educational community continues to close the minds of 
newer computer scientists by teaching “truths” that are out 
of perspective with today’s problems. 
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(2) Queuing algorithms that change the order of writes go- 
ing to the disk prevent applications from using fail-safe up- 
dates to large data bases. With an unknown write ordering, it 
is impossible to back out certain update transactions after a 
system crash. FIFO handling of writes is a must. 

(3) The standard Unix dsort gives preference to reads and 
defers all writes to improve response times. This is generally 
the best policy to prevent blocking on buffered output data. 
Unfortunately, the standard implementation also defers 
writes for swapping and paging as well. This ties up the swap 
and paging buffer headers for long times when several active 
readers can lock down the request queue. This results in step 
reductions or nonlinear decay in both system throughput and 
system efficiency as the disk queue length increases. 

(4) Any algorithm that allows one or more processes to domi- 
nate the queue is bound to cause a wide variance in response 
times. Since slow response times are subjective (that is, the 
user remembers only the worst), then algorithms that gener- 
ate wide variances are likely to create the “slow response 
time” conditions that the user will see and remember at ran- 
dom times. If the variance gets worse as the load increases, 
then the load will become more visible to the user than would 
normally be expected. 

With these requirements in mind it is clear that the stan- 
dard dsort is nonoptimal for a timesharing system. The stan- 
dard up-elevator algorithm with deferred writes allows a sin- 
gle active reader of a sequentially allocated file to lock up the 
disk queue with readahead. This will continue for a maxi- 
mum scheduling quantum of several seconds. Several such 
users can create service time delays to other processes in the 
disk queue of several times the scheduling quantum! If the 
system is swapping or paging at the same time, then swap 
and page requests are likely to be serviced once per few sec- 
onds—this allows the incore process hogging the queue to do 
so for even longer periods of time. 

The typical up-down elevator algorithm is even worse. The 
requests for I/O at the ends of the service area get serviced 
only once per pass, while the middle gets serviced twice per 
pass. The result is a normal distribution for the probability of 
service and a process throughput as a function of the location 
of the file. Processes accessing data at the ends of the request 
area typically get between 5 — 50% of the normal throughput 
depending on queue length and access patterns. Note that 
for most Unix systems the swap/paging areas and the in- 
odes/directories tend to be at one end of the service pattern. 
The typical result is exec/fork operations that are signifi- 
cantly degraded as the queue length increases, resulting in 
abnormal response times for simple commands. When 
swap/paging traffic is affected by this, the system suffers a 
large step reduction in efficiency and throughput as the 
swap/paging time exceeds the scheduling quantum. 

To fix this behavior requires that lockdown be bounded to 
short bursts (some lockdown is desired to obtain higher 
throughputs), and that swapping or paging always get pre- 
mium service. 

The proper algorithm is one that sorts the disk queue in 
the reverse direction from that in which file data is sequen- 
tially allocated. This is down-elevator on most Unix systems. 
Second, writes on minor devices with file systems are queued 
FIFO and serviced after all outstanding read requests and 








swap /page requests have been serviced. 

A better variation of this is to service small batches of 
writes that fall into the natural down-elevator algorithm. 
Thus, on every pass a few writes are taken off the queue and 
released. This helps prevent the write-deferred buffer from 
clogging up the buffer pool. The writes are still done FIFO 
but do not cause a burst of nonoptimal FIFO traffic in some 
random access pattern. 


Better Serial Interrupt Handling 

Character-at-a-time, interrupt-driven servicing can use up 
large amounts of high-priority, nonschedulable cpu time. 
For most systems, the time to service an input keystroke in 
raw mode is between 800 and 3500 microseconds. This in- 
cludes the time required to process that hardware interrupt, 
save system state, call the high-level receiver interrupt rou- 
tine, echo the character, start the output, wake up the sleep- 
ing application, and do a context switch to run the process. 
Not included is the additional 2500 to 4000 microseconds 
that it takes to perform the read system call and schedulable 
kernel-level handling of the input data. At 2400-4800 
baud, most systems are totally cpu bound and will lose in- 
coming data. Normally humans don’t type that fast, but re- 
peat functions and multicharacter function keys do! 

A common solution to this problem is to handle the receiv- 
er and transmit interrupts in a short assembly language in- 
terrupt routine. This routine uses a 50 — 200-character dedi- 
cated output buffer and a shared 300 — 2000-character input 
buffer. The tightly coded output interrupt routine requires 
30 — 90 microseconds per character, and the normal output 
routines require 10-200 microseconds per character to 
keep the output buffer full. Similar numbers are true for 
input. Wakeups are done only on buffer full or empty. A 
watchdog timeout routine calls the input processor every few 
clock ticks to process incoming data when the buffer doesn’t 


get full. The net effect is a 70-95% reduction in cpu time 


for serial communications traffic and significantly reduced 
chances of dropping input characters. 
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“You are in a dark, musty, source 
code directory, with many mysterious- 
ly named source files around you...” 


number of books and manuals 
A describe how to use the Unix 
operating system. However, 
Unix internals documentation is pretty 
scattered (where it exists at all). This is 
unfortunate, especially for those of us 
who work with Unix—the lack of de- 
sign documents makes our jobs harder. 
Some public domain Unix-like operat- 
ing systems (GNU and XINU) are in 
the works for the rest of the world, and 
a number of worthwhile ideas in Unix 
are adaptable to other systems. In the 
next few years, documentation on the 
Unix algorithms and data structures 
will become more valuable to many 
people than the actual source code li- 
censes for Unix. 


how something works is to “grep for it” 
in the source code (in fact, there are t- 
shirts that say “grep for it!””). This isn’t 
always desirable, however, because 
some of us don’t have access to the 
source code, or, if we do, the source 
isn’t particularly lucid. A comment in 
the code even says, “You aren’t sup- 
posed to understand this’’! 

I’ve since given up on finding one 
comprehensive document, but I’ve be- 
come aware that bits and pieces of de- 
sign documentation are available. Be- 
cause most of this documentation is in 
fairly obscure places, I’ve put together 
a bibliography to help other people 
find the information they need. 


Using this Bibliography 

I have divided the main body of this 
article into seven subject areas: the ker- 
nel, the shell, compilers and language 


Fe a ae a a en ie ree en 


You are supposed to understand this. 


poe a ee ee 


Most Unix gurus will tell you that, 
because Unix is small, written in a 
high-level language, and available 


with the source code, documentation 


isn’t as necessary as it is for some other 
systems. However, Unix has enough 
code to make earning the title “Unix 


guru” quite a task. For the first year or . 


two that I was working with Unix, I 
kept thinking “there has to be some 
sort of design document that Bell Labs 
hasn’t released,” but I haven’t found it 
yet. The normal means of discovering 
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development tools, communications, 
the C runtime library, miscellaneous 
utilities, and regular expressions. This 
is followed by a list of references in al- 
phabetical order by author. Although 
the organization may seem a little arbi- 
trary, I don’t think people will have 
problems finding what they want. 
Within the main body of this article, 
books, papers, research reports, maga- 
zine articles, and the like are cited with 
the author’s name in square brackets; 
complete bibliographical information 
appears in the list of references. In the 
few places where man page references 
appear, I use the standard form (e.g., 
LS(1) refers to the man page for “‘ls” in 
section 1 of volume 1 of the manual). I 
have adopted the numbering scheme 
used in almost every major release ex- 
cept System V (i.e., section 4 has device 
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drivers, and section 5 has file formats); 
most other things are unchanged. 

K&R, of course, refers to The C 
Programming Language by Ker- 
nighan and Ritchie (see [Kernighan 
and Ritchie78a] in the list of refer- 
ences). UPM is short for the Unix Pro- 
grammer’s Manual, which almost al- 
ways comes in two volumes: the first 
contains the man pages, and the sec- 
ond contains a number of papers about 
Unix (some of which are referenced 
later). BSTJ is the Bell System Tech- 
nical Journal (now the AT&T Bell 
Laboratories Technical Journal), 
available from Room 1J319, 101 J. F 
Kennedy Parkway, Short Hills, NJ 
07078. CSTR stands for Computer 
Science Technical Report, available 
(for free) from Room 2C-213, AT&T 
Bell Laboratories, Murray Hill, NJ 
07974. CSRG is the Computer Sci- 
ence Research Group at U. C.- 
Berkeley. 


The Kernel 

A group of people at Purdue Universi- 
ty wrote a public domain operating 
system named XINU (a recursive acro- 
nym for “XINU Is Not UNIX”); the 
source code has been published in 
[Comer]. Although XINU has a lot of 
the flavor of Unix (especially since it’s 
written in C), it is not a complete time- 
Sharing system by any means; there 
are no Shells or utilities, for instance. 
For someone unfamiliar with Unix in- 
ternals, this is a good place to get ac- 
quainted with the concepts used in the 
Unix kernel. For someone who has al- 
ready read some of the source code to 
Unix’s kernel, however, the XINU code 
is kind of disappointing. 

A document [Lions77] put together 
for an operating systems course at the 
University of New South Wales in 
Australia describes the Unix kernel in 
some detail. Because it takes the form 
of annotations to the source code (by 
line number), it isn’t much use without 
a source listing (see, for instance, [Li- 
ons76]). Unfortunately, the document 
is based on Version 6; there have been 
four major releases of Unix since then, 
so it’s not exactly current. 

[Lions77] presents another problem 
for people without source licenses. Be- 
cause it contains a lot of details about 
the kernel, you’re supposed to have a 
Unix source license to get a copy. Nev- 
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ertheless, lots of bootleg copies are 
floating around. For that reason and for 
the sake of completeness, I’m mention- 
ing this document here. For more infor- 
mation on the whole topic, see [Li- 
ons78], which is available to the public. 


Allocation of Directory Entries 
Allocation of directory entries in most 
releases of Unix is pretty trivial; 4.2 
BSD is the only major exception. See 
the DIR(S) man page for details on 
that. 


Allocation of Disk Blocks and 

Inodes 

[McKusick, Joy, Leffler, and Fabry] 
discusses allocation of data blocks and 
inodes in 4.2 BSD. In other releases of 
Unix, this allocation tends to be sim- 
pler; see the FILSYS(5), FS(5), or 
FS(4) man page entry for details. 


Booting 

[Christian] has a pretty good piece 
(section 19.5) on booting, titled ““Boot- 
ing, Process 0, Process 1.”’ Since boot- 
ing seems to be different in every re- 
lease and on every machine, read this 
with a grain of salt. Section 8 of your 
Unix manual probably has more detail 
and accuracy than anything else. 


Device Drivers: General 

If you have no idea how Unix’s device 
drivers fit in with the rest of the kernel, 
you might want to read [Comer]; it 
gives you the flavor of the subject, al- 
though a fair number of the details are 
different from Unix (remember, he’s 
writing about XINU). 

Once you have a rough idea of how 
device drivers fit into Unix (i.e., via 
major and minor device numbers and 
the device ‘‘switches’’), then [Rit- 
chie78] is the thing to read: it discusses 
the device-switch tables as well as the 
kernel routines nulldev( ), cpass( ), 
passc( ), iomove( ), getc( ) and putc( ) 
(not to be confused with the standard 
I/O routines of the same names), 
sleep( ), wakeup( ), timeout( ), spl3( ) 
and so on, bread( ), getblk( ), 
breada( ), brelse( ), bwrite( ), baw- 
rite( ), bdwrite( ), geterror( ), and 
physio( ). 

Because [Ritchie78] is terse (like 
most of Unix), you might want to read 
something that goes a little slower and 
gives examples. [McNamara, Vaish, 


and Bryant], which examines various 
aspects of device drivers in detail and 
gives two pages of pseudo-code for a 
block device driver, discusses sleep( ), 
wakeup( ), timeout( ), physio( ), spl0- 
7(), disksort( ), iowait( ), and 
deverror( ). 

If you’re actually going to write a 
device driver, then you may need all 
the help you can get. [Nystrom] is 
pretty much the complete authority, 
with hundreds of pages, lots of source 
code, and reprints of [Hickman83a] 
and [Hickman83b]. Unfortunately, 
you also need a Unix source license, 
and I’m not sure if that is available 
other than by taking a seminar from 
International Technical Seminars (see 
the list of references). 

One last suggestion: According to an 
article on Usenet by John Levine at 
INTERACTIVE Systems (john@ima- 
.UUCP), “the PC/IX manual includes 
a fairly informative section on writing 
device drivers.” I haven’t seen a copy 
yet. 


Device Drivers: Block 

[Ritchie78] discusses buffer headers 
and associated routines. [Hick- 
man83a] is another source of informa- 
tion. As mentioned earlier, [McNa- 
mara, Vaish, and Bryant] gives two 
pages of pseudo-code for a block device 
driver. 


Device Drivers: Character 
[Thompson] and [Ritchie78] look at 
“character lists” (really queues) and 
the routines that access them. 


Directories 

Chapter 8 in [Kernighan and Ritchie 
78a] discusses the format of directo- 
ries. In [Kernighan and Pike] (page 
59) is the comment that an inode num- 
ber of zero indicates an empty directo- 
ry entry. 


exec/( ) 

[Johnson and Ritchie 77] mentions 
that exec( ) builds the argument list 
for a new program by allocating mem- 
ory on the stack. 


File 1/O 

[Thompson] in section 4.1 gives some 
information on the processing done by 
open( ), including descriptions of the 
per-user file table, the system file table, 
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and the inode table; [Christian] in sec- 
tion 19.6 more or less repeats the same 
information. [Ritchie78] discusses 
opens on devices. See also namei( ) be- 
low—namei( ) is called indirectly when 
the user does an open( ) or creat( ). 


getty 

[Christian] in section 19.5 examines 
the relationships between init, getty, 
and login, though not in much detail. 
Note that the parameters passed to 
getty tend to vary from one implemen- 
tation of Unix to the next. See the 
GETTY(8) or GETTY(1M) man page 
for details. 


iget( ) and iput( ) 

[Wales] discusses iget( ) and iputt ). 
iget( ) is called to locate or read in an 
in-core copy of an inode, given its in- 
ode number; reference counts are used 
to keep track of how many processes 
are using a given inode. iput( ) decre- 
ments the reference count and, when 
the reference count goes to zero, frees 
the in-core copy, writing it out to disk 
if it has been modified. 

[Wales] also discusses the hashing 
used to find in-core inodes—and the 
use of a singly linked list if collisions 
occur. [Lankford] mentions that, as of 
System V and 4.1 BSD, inode table en- 
tries are hashed (in releases prior to 
those, the table was searched sequen- 
tially), and [Ritchie79] notes that in 
the original PDP-7 Unix, iget( ) left the 
inode it found in a constant location. 


init 

Section 6.6 in [Ritchie and Thompson ] 
gives a superficial overview of how init 
works (ignoring both getty and login). 
The INIT(8) (or INIT(1M))man page 
provides more detail. Of course, init 
keeps changing from one release to the 
next. [Gauthier] in section 19.5 sup- 
plies a great deal of detail about how 
process | is created “from scratch.” 


Memory Management 

[Johnson and Ritchie 77] includes a 
short discussion of various aspects of 
memory management in the Unix ker- 
nel. [Thompson] observes that “the 
swapping process is the only process 


that waits for primary memory to be- 
come available.”’ 


mount( ) 
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[Ritchie and Thompson] in section IV 
and [Thompson] in section 4.2 discuss 
how the mount table is built and how 
namei( ) uses it. 


namei( ) 

This routine in the kernel converts 
from a path name to an inode number. 
It is mentioned in [ Leffler, Karels, and 
McKusick], along with the fact that 
4.2 BSD has namei( ) caching—with a 
table of names, inode numbers, device 
numbers, and pointers to inode table 
entries. This same source explores the 
logic used by namei( ). Sections 4.1 
and 4.2 in [Thompson] discuss various 
aspects of the translation of the name 
to the inode number. (See also iget( ) 
and iput( ) above. ) 


Process Table 
[Leffler, Karels, and McKusick] men- 
tions that the newproc( ) routine in the 
kernel does a linear search of the pro- 
cess table to allocate an ID for each 
new process. [Goodwin] describes in 
significant detail various algorithms 
for allocating new process IDs. 
[Leffler, Karels, and McKusick] 
also gives a list of other kernel routines 
and/or system calls that do sequential 
searches of the process table, as well as 
the reasons for each search. The rou- 
tines are: exit( ), wait( ), fork( ), new- 
proc( ), kill( ), gsignal( ), schedcpu( ), 
and sched( ). 


Read-ahead 

The Unix kernel implements a read- 
ahead scheme where the kernel tries to 
predict which disk blocks will need to 
be read in and to read them in before 
they are actually requested by a user 
program. This is discussed in [Rit- 
chie78]. [Goodwin] proposes an im- 
provement on the algorithm. 


Scheduling 

[Gauthier] in section 19.3 looks briefly 
at scheduling, as does [Thompson] in 
section 2.3. You can glean other de- 
tails from a careful reading of the 
PS(1) man page. 


u page 

Much of the data about a process is 
stored in the u page (so called because 
the global variable with its address is 
named “u’’); this is discussed in [Rit- 
chie78] and [Goodwin], where it is 


called the per process data area, and in 
[Thompson], where it is called the sys- 
tem data segment. Note that a u page 
is different from a process table entry 
(of which there is also one per process): 
the u page is swapped to disk, while the 
process table entries are always resi- 
dent in main memory. 


Update Process 

[Gauthier] on page 204 mentions the 
update process (with /etc/update 
showing in the “ps” example). On page 
213 is the comment: “the /etc/update 
program forces disk updates every 
thirty seconds and should be run at ev- 
ery installation.” 


The Shell 

[Ritchie and Thompson] in section 6.5 
describes the shell’s use of exec( ), 
fork( ), wait(), and read( ); how it 
handles pipes and I/O redirection; and 
how shell scripts work. 


Background Processes 
[ Joy] shows how the C shell handles its 
table of background processes. 


cd 

Most man pages for CD(1) (or 
CHDIR(1)) mention that the com- 
mand must be built into the shell; [ Rit- 
chie79] gives an interesting historical 
note on how the authors of Unix dis- 
covered this. 


Filename Expansion 
See the section on regular expressions 
(page 56). 


1/O Redirection 
[Holt] on page 169 gives a sketchy de- 
scription of how this is handled. 


Running Programs 

[ Holt] on pages 167-168 presents some 
pseudo-code for the steps a shell goes 
through when it creates a subshell and 
runs a given program; it does not, how- 
ever, describe how shell scripts are 
handled when they are run. See also 
the discussion of the system( ) subrou- 
tine in the section on the C runtime 
library (page 54.) 


Compilers and Language 
Development Tools 

cpp 

[Johnson and Lesk] mentions that the 
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C preprocessor is written using yacc 
and lex. Martin Minow posted a com- 
plete public domain cpp to Usenet this 
summer, and another partial imple- 
mentation (‘“‘p’’) is given with full 
source code listings in [Schreiner]. 


lex 

[Johnson and Lesk] states that lex is 
written using yacc. [Aho and Ullman] 
has quite a bit of the theory concerning 
lex in its chapter 3. See also the section 
on regular expressions. A public do- 
main version of lex is available from 
Decus. 


lint 
[Johnson78a] touches on the design of 


lint in the section on implementation. 


pcc 
[Johnson and Lesk] mentions that pec 
is written using yacc and lex. 

[Johnson79] is a long, detailed in- 
troduction to the guts of the portable C 
compiler. It discusses parsing, symbol 
table handling, expression trees, and 
register allocation. It gives a couple of 
examples of the templates used to re- 
write expression trees and eventually 
to generate code, as well as a number 
of the function and source filenames 
for the compiler. 

[Leffler] is an exhaustive document 
(100 pages, although some of it applies 
only to the Harris /6). It examines the 
organization of the compiler in great 
detail, giving source file and function 
names throughout. Surprisingly, it 
gives very few examples of expression 
trees and rewriting templates. It is very 
good nonetheless. 


The Ritchie (PDP-11) C Compiler 
[Ritchie76] is, of course, the authori- 
tative paper on the PDP-11 C compiler. 
(Most C compilers are derived from 
pec, but there are a few... .) 
[Pammett] discusses porting the Rit- 
chie C compiler to the T1990. For a pa- 
per of this size (200+ pages), it says 
amazingly little about how the compiler 
works. An appendix, however, gives a 
detailed description of the code tables. 


yacc 

[Johnson78b] examines how the 
parser built by yacc operates and pro- 
vides a detailed example of a parse ta- 
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ble. The theory behind yacc gets atten- 
tion in [Aho and Ullman], which 
contains pointers to other papers and 
books on the subject as well. This book 
also presents the grammar and parse 
table for a subset of eqn. 

A public domain implementation of 
yacc is available from Decus. 


Communications 


Networking in 4.2 BSD 

[Leffler, Joy, and Fabry] devotes 29 
pages to the nitty-gritty of sockets and 
protocol handling in the 4.2 kernel. 


UUCP 
[Nowitz] discusses queuing, work file 
formats, control files, and a bunch of 
the ‘‘setup” protocol, but doesn’t offer 
much about the main file transfer pro- 
tocol (the “g” protocol). [Nowitz and 
Lesk] looks at the initial handshaking. 
For those who are really interested 
in how the “‘g” protocol fits into UUCP, 
Piet Beertema of CWI in Amsterdam 
(piet@mevax.UUCP) wrote another 
protocol—the “‘f” protocol for use on 
X.25 networks—that ‘‘drops into” 
UUCP. The source code for this proto- 
col is public domain and was posted to 
Usenet this summer. 


The C Runtime Library 


bsearch{ ) 

bsearch( ), the binary search routine 
from System V, uses algorithm B in 
section 6.2.1 of [Knuth] (according to 
the man page). 


Calling Sequences 
[Johnson and Ritchie 81] discusses 
these in great detail. 


ctype (isalpha( ), isascii( ), etc.) 
This is pretty trivial, but a paper was 
actually published that talks about 
how the CTYPE(3) macros work; see 
[Gimpel] if you’re interested. 


dbm(3) 

The algorithm used by the data base 
routines dbminit( ), etc., which are 
documented in the DBM(3) man page, 
is described in [Fagin, et al.], [Carter 
and Wegman], and possibly in the No- 
vember 1982 BSTJ (part two). 


hsearch({ ), hcreate( ), hdestroy( ) 


These hash table routines (in System 
V) use algorithm D from section 6.4 of 
[Knuth] (according to the man page). 


isatty( ) 

[Arnold] mentions that isatty( ) sim- 
ply calls gtty( ) and checks the return 
value. 


Isearch({ ), lfind( ) 
These linear search routines (Ifind( ) 
was added in System V, release 2) use 


algorithms from section 6.1 of 
[Knuth]. 


Memory Allocation 

[Kernighan and Ritchie 78a] gives list- 
ings of alloc( ) and free( ) in section 
8.7. Various algorithms are used in dif- 
ferent releases of Unix: System V has 
two different versions of malloc( ), and 
4.2 BSD supposedly has a power-of- 
two allocation scheme. 


printf( ), fprintf( ), and sprintf ) 

For source listings of more or less com- 
plete printf( ) functions, see [Hendrix] 
or [Comer]. 

Some versions of the printf( ) family 
call an internal routine named 
_doprnt( ): see, for instance, | Ker- 
nighan and Pike], page 189. Eric 
Kiebler (eric@washu.UUCP) posted 
this to Usenet a while back: 

“BEWARE the _doprnt 

code, my son! 

The bits that twitch; 

the types that clash! 

Use the portable 

varargs stuff, 
Avoid the _doprnt’s 
teeth that gnash!”’ 


qsort( ) 

This uses the quicker-sort algorithm, 
which has been described everywhere 
including section 5.2.2 of [Knuth]; see 
especially page 123 where qsort( ) 
chooses a trial median from the center 
of the list. 


stdio 
A great deal of detail on the workings 
of the standard I/O library is given in 
chapter 8 of [Kernighan and Ritchie 
78a]. 


Strings (strcmp( ), strtok( ), etc.) 
A public domain implementation of 
the various string functions (literally 
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dozens of them) was written by Henry 
Spencer and posted to Usenet. 


system( ) 

Listings of various versions of the sys- 
tem( ) subroutine abound; see [Ker- 
nighan and Pike], pages 223-229, and 
[Kernighan and Ritchie 78b], section 6. 


System Calls 

Some manuals give the assembly lan- 
guage statements necessary to invoke a 
given system call (V7 and 4.1 BSD 
both do this). Later versions of Unix, 
however, don’t do this, presumably be- 
cause almost no one writes in assembly 
language anymore. See the section on 
the kernel (page 51). 


tsearch( ), tfind( ), tdelete( ), 
twalk( ) 

These routines from System V are for 
working with binary trees; they use al- 
gorithms T and D given in section 6.2.2 
of [Knuth]. 


Miscellaneous Utilities 


adb 

You can get some hints on how adb 
does its work from the PTRACE(2) 
(process trace) man page; note that the 
details of the system call differ de- 
pending on the hardware and the Unix 
release. 


ar 

There are various versions of ar (file 
archiver) floating around. The most 
recent one (in 4 BSD and System V, 
Release 2) has a public domain equiva- 
lent in the par (portable archive) and 
unpar programs. 


at 
[Thomas and Yates] discusses atrun 
and /usr/spool/at. 


awk 

[Aho, Kernighan, and Weinberger] 
has a particularly concise paragraph in 
section 5 that explains how awk works: 
it uses yacc and lex; regular expres- 
sions are handled by deterministic fi- 
nite automata; awk builds a parse tree 
from the program, which is interpreted 
when actually processing data. [Ker- 
nighan and Pike] mentions on page 
124 that awk uses hashing to imple- 
ment its associative arrays. See also 
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the section on regular expressions. 


be 

The BC(1) man page mentions that be 
is a preprocessor for dc (see below). 
Various authors note that it is written 
using yacc. 


bdiff 

[McGilton and Morgan] on page 173 
says that bdiff uses split and diff to do 
its work. 


dc 

[Morris and Cherry] discusses certain 
details of dc, including how it does 
arithmetic and the dynamic storage al- 
location method it uses (described in 
more detail in [ Knowlton]). 


df 

The df (display filesystems) utility cal- 
culates the amount of free space on a 
file system differently in different re- 
leases: in V7 it reads the disk’s free 
list, in 4.x BSD it reads the superblock, 
and in Systems III and V it uses the 
ustat(2) system call. (This information 
is from Usenet. ) 


diff 

The algorithm used in diff was devel- 
oped (independently) by Harold Stone 
and by Wayne Hunt and Tom Szy- 
manski; see [Hunt and Szymanski] or 
[Mcllroy and Hunt] for details. 


echo 

Just about every book on C shows how 
the echo command accesses the com- 
mand line arguments; [Kernighan and 
Ritchie 78a] gives three different ver- 
sions on page I 11. 


ed 

You can get some of the flavor of ed 
from [Kernighan and Plauger 76] and 
[Kernighan and Plauger 81]; see also 
the section on regular expressions. 


egrep 

egrep uses an extended version of the 
normal regular expression algorithms; 
see the section on regular expressions. 


eqn 

[Kernighan and Cherry] in sections 5 
and 6 supplies various details about the 
design of eqn, including a simplified 
version of the yacc grammar that it 


uses. 


fgrep 

[Whale] gives the source code for a 
public domain version of fgrep; the 
comments discuss the Knuth-Morris- 
Pratt string-matching algorithm. 


grep 

[Kernighan and Pike] discusses the 
tradeoffs between the different algo- 
rithms used in grep, fgrep, and egrep. 
See the section on regular expressions. 


passwd (command) 
[Gauthier] provides on page 196 a 
short explanation of why the passwd 
command must be set-uid root (if this 
isn’t already obvious). 


pwd 
[Kernighan and Pike] gives hints on 
pages 51-52 about how pwd works. 


spell 
See [Kernighan and Pike], page 314, 
[Peterson], and [Mcllroy]. 


Regular Expressions 

Regular expressions are used to vary- 
ing degrees in awk, ed, egrep, Jim Gos- 
ling’s emacs, grep, lex, rn (a “read- 
news” replacement that was posted to 
Usenet this summer), sed, the shells, vi 
(Berkeley’s screen-oriented editor), 
and yacc. While they’re very popular 
under Unix, they aren’t used very often 
in other environments. Rather than 
discuss regular expressions under each 
utility that uses them, I’ve collected all 
the information here. 


Implementation 

[Holub] contains source code in C for 
a version of grep that implements full 
regular expressions. [Kernighan and 
Plauger 76] and [Kernighan and 
Plauger 81] give source code to handle 
slightly different regular expressions in 
RATFOR and Pascal, respectively. 


Theory 

The standard reference is [Aho and 
Ullman], which cites various other 
publications on the subject. [Aho and 
Corasick] may also be a worthwhile 
paper to read; I haven’t seen a copy 
yet. 


References 


Dr. Dobb’s Journal, December 1984 


It’s a real bargain! Here’s why: 


e Only $49.95 plus shipping 
e 8080 to Z-80 Source Code 
Converter 


e Generates Microsoft com- 
patible REL files or INTEL 
compatible hex files 


e Compatible with Digital 


Research macro assem- 
blers MAC & RMAC 


e Generates Digital Research 
compatible SYM files 

e Full Zilog mnemonics 

e INCLUDE and MACLIB files 

¢ Conditional assembly 

e Separate data, program, 





common and absolute pro- 
gram spaces 

Customize the Macro 
Assembler to your require- 
ments with installation 
program 

Over 3 times faster than 
Microsoft M80 macro 
assembler 

Z-80 Linker and Library 
Manager for Microsoft com- 
patible REL files available 
as a total package with 
Macro Assembler for only 
$95.00 


e Manual only is $15 


Circle no. 66 on reader service card. 


a MULTI-TASKING for the IBM AT! 


also for the IBM PC or XT 
with MULTI-JOB™ 


““MULTI-JOB the most cost effective 
choice for the user with a need for multi- 
tasking.’’ PC Age Vol. 3.8 


With MULTI-JOB software up to 9 IBM PC DOS compatible 
programs can be running at the same time. Example, have your com- 
munication program running in the background, and still be using 
your word processing, spreadsheet programs, etc., at the same time! 
The keyboard and screen can be assigned to any job with a simple 
keystroke. The remaining jobs will continue to run unattended. With 
the many different options, MULTI-JOB is avery powerful 


package. 


* No special hardware is required. 
* Allows priorities to be given between each job. 
* Programs can be run simultaneously or one at a time. 


* 30-day free trial period. 


MULTI-JOB 
ELECTRONIC DISK 
SPOOL PROGRAM 


SET MEMORY UTILITY 


$159.00 
$ 49.00 
$ 24.00 
$ 24.00 


B&L COMPUTER CONSULTANTS, 7337 Northview, 7x 
Suite B, Boise, ID 83704, (208) 377-8088. 


Dealer’s inquiries are welcome. Call or write for a free catalog. 





Circle no. 11 on reader service card. 


Eee 


33 KFLOPS 








Use your IBM PC, XT or AT to multiply 
two 128 by 128 matrices at the rate of 33 
thousand floating-point operations per 
second (kflops)! Calculate the mean 
and standard deviation of 16,384 points 
of single precision (4 byte) float- 
ing-point data in 1.4 seconds (35 
kflops). Perform the fast Fourier trans- 
form on 1024 points of real data in 6.5 
seconds. Near PDP-1 1/70 performance 
when running the compute intensive 
Owen benchmark. 


WL FORTH-79 


FORTH-79 by WL Computer Systems is 
a powerful and comprehensive pro- 
gramming system which runs on the 
IBM PC (and some compatibles) under 
PC DOS 1.1 or later. If your computer 
has the 8087 numeric data processing 
chip (NDP) installed, then this version of 
FORTH-79 will unleash the awesome 
floating-point processing power which 
is present in your system. If you haven't 
gotten around to installing the 8087 
NDP coprocessor in your computer, 
you can still use WL FORTH to write 
applications using standard FORTH- 
79. 


























System includes editor, memory dump, 
decompiler, nondestructive stack print- 
out, screen printer and screen copy util- 
ities. FORTH sources for these utilities 
are included. 








Unlike most other products, the com- 
plete source is available at a very 
affordable price. 









Package 1 includes FORTH-79 ver- 
sions with and without 8087 support. 
Included are screen utilities, 8087 and 
8088 FORTH assemblers. $100 








Package 2 includes package 1 plus the 
assembly language source for the WL 
FORTH-79 nucleus. $150 







Package 3 includes package 2 plus the 
WL FORTH-79 source screens used to - 
add the 8087 features to the vocab- 

ulary. $200 







Starting FORTH book. $22 






WL Computer Systems 
1910 Newman Road 
W. Lafayette, IN 47906 
(317) 743-8484 


Visa and Master Card accepted. 









IBM is a trademark of International Business Ma- 
chines 






Circle no. 110 on reader service card. 


[Aho and Corasick] “Efficient 
String Matching: An Aid to Biblio- 
graphic Search,” by Alfred V. Aho 
and M. J. Corasick, in Communica- 
tions of the ACM, 1975, volume 18, 
pages 333-340. 

[Aho, Kernighan, and Weinberger] 
‘“Awk—A Pattern Scanning and Pro- 
cessing Language,” second edition 
(September 1978), by Alfred V. 
Aho, Brian W. Kernighan, and Pe- 
ter J. Weinberger, in UPM, volume 
2. (The first edition of this paper 
(July 1978) is available in Soft- 
ware—Practice and Experience, vol- 
ume 9.) 

[Aho and Ullman] Principles of Com- 
piler Design, by Alfred V. Aho and 
Jeffrey D. Ullman, Addison-Wes- 
ey 1977. 

[Arnold] “Screen Updating and Cur- 
sor Movements Optimization: A Li- 
brary Package,” by Kenneth C. R. 
C. Arnold, in UPM for 4.x BSD, vol- 
ume 2. 

[Bach and Buroff] “A Multiprocessor 
Unix System,” by Maurice J. Bach 
and Steven J. Buroff, in USENILX 
1984 Summer Conference Proceed- 
ings, 1984. (See [USENIX Summer 
°84].) 

[Bourne] The Unix System, by Steve 
R. Bourne, Addison-Wesley, 1982. 
[Carter and Wegman] ‘Universal 
Classes of Hash Functions,” by Car- 
ter and Wegman, in Proceedings of 

9th SIGACT 1977. 

[Christian] The Unix Operating Sys- 
tem, by Kaare Christian, John Wi- 
ley and Sons, 1983. 

[Comer] Operating System Design, 
The XINU Approach, by Douglas E. 
Comer, Prentice-Hall, 1984. 

[ Fagin, et al.] “Extendible Hashing—A 
Fast Access Method for Dynamic 
Files,” by Fagin, Nievergelt, Pip- 
penger, and Strong, in Transactions 
on Database Systems, 1979, volume 
4, number 3. 

[Gauthier] Using the Unix System, by 
Richard Gauthier, Reston, 1981. 
[Gimpel] ““The Minimization of Spa- 
tially. Multiplexed Character Sets,” 
by James F. Gimpel, in Communic- 
tions of the ACM, June 1974, vol- 

ume 17, number 6, pages 315-318. 

[Goodwin] “System V Performance 
Enhancements,” by Ken Goodwin, 
in ,login:, July 1984, volume 9, num- 
ber 3, pages 6-11. 


58 


[Hendrix] The Small-C Handbook, 
by J. E. Hendrix, Reston, 1984. 

[Hickman83a] ‘““The Unix Buffer 
Mechanism—A Detailed Look,” by 
Kipp E. B. Hickman, 1983. (Re- 
printed in Writing Unix Device 
Drivers; see [Nystrom]. ) 

[Hickman83b] “The Basics of Writing 
Unix Device Drivers, with Refer- 
ences to the Motorola 68000,” by 
Kipp E. B. Hickman, 1983. (Re- 
printed in Writing Unix Device 
Drivers; see [Nystrom ].) 

[Holt] Concurrent Euclid, the Unix 
System, and Tunis, by R. C. Holt, 
Addison-Wesley, 1983. 

[Holub] ““GREP.C-A Unix-like, Gen- 
eralized, Regular Expression 
Parser,’ by Allen Holub, in Dr. 
Dobb’s Journal, October 1984, 
number 96. 

[Hunt and Szymanski] “A Fast Algo- 
rithm for Computing Longest Com- 
mon Subsequences,” by J. W. Hunt 
and Tom G. Szymanski, in Commu- 
nications of the ACM, May 1977. 

[Johnson78a] “LINT-A C Program 
Checker” (July 26, 1978), by Ste- 
phen C. Johnson, in UPM, volume 2. 
(Also available as CSTR, number 
65.) 

[Johnson78b] ““YACC: Yet Another 
Compiler-Compiler’’ (1978), by 
Stephen C. Johnson, in UPM, vol- 
ume 2. (Also available as CSTR, 
number 32.) Note: the date for this 
is variously given as 1974, 1975, or 
1978; because it contains references 
to items published in 1978, that 
seems to be the correct date. 

[ Johnson79] “A Tour Through the Por- 
table C Compiler” (1979), by Ste- 
phen C. Johnson, in UPM, volume 2. 

[ Johnson and Lesk] “Language Devel- 
opment Tools’ (December 27, 
1977), by Stephen C. Johnson and 
Michael E. Lesk, in BSTJ, July /Au- 
gust 1978, volume 57, number 6, 
part 2. 

[Johnson and Ritchie 77] “Portability 
of C Programs and the Unix Sys- 
tem” (December 5, 1977), by Ste- 
phen C. Johnson and Dennis M. Rit- 
chie, in BSTJ, July/August 1978. 

[Johnson and Ritchie 81 ] ““The C Lan- 
guage Calling Sequence” (Septem- 
ber 1981), by Stephen C. Johnson 
and Dennis M. Ritchie, CSTR, num- 
ber 102. 

[Joy] ‘An Introduction to the C 


Shell,” by William N. Joy, in UPM 
for 4.x BSD, volume 2. 

[Kernighan and Cherry] “A System 
for Typesetting Mathematics,” by 
Brian W. Kernighan and Lorinda L. 
Cherry, in UPM, volume 2. (An ear- 
lier version of this appeared in Com- 
munications of the ACM, March 
1975.) 

[Kernighan and Pike] The Unix Pro- 
gramming Environment, by Brian 
W. Kernighan and Rob Pike, Pren- 
tice-Hall, 1984. 

[Kernighan and Plauger 76] Software 
Tools, by Brian W. Kernighan and 
P. J. Plauger, Addison-Wesley, 
1976. 

[Kernighan and Plauger 81] Software 
Tools in Pascal, by Brian W. Ker- 
nighan and P. J. Plauger, Addison- 
Wesley, 1981. 

[Kernighan and Ritchie 78a] The C 
Programming Language, Brian 
Kernighan and Dennis M. Ritchie, 
Prentice-Hall, 1978. 

[Kernighan and Ritchie 78b] “Unix 
Programming-Second Edition” 
(November 12, 1978), by Brian 
Kernighan and Dennis M. Ritchie, 
in UPM, volume 2. 

[Knowlton] “A Fast Storage Alloca- 
tor’ (October 1965), by K. C. 
Knowlton, in Communications of 
the ACM, volume 8, pages 623-625. 

[Knuth] The Art of Computer Pro- 
gramming—Volume 3, Sorting and 
Searching, by Donald E. Knuth, Ad- 
dison- Wesley, 1973. 

[Lankford] “Unix System V and 4 
BSD Performance,” by Jeffrey P. 
Lankford, in USENIX 1984 Summer 
Conference Proceedings, 1984 (See 
[USENIX Summer’84].) 

[Leffler] ‘“‘A Detailed Tour Through 
the /6 Portable C Compiler,” 
(19807), by Samuel J. Leffler, De- 
partment of Computer Engineering, 
Case Western Reserve University. 

[Leffler, Joy, and Fabry] “4.2 BSD 
Networking Implementation 
Notes” (July 1983), by Samuel J. 
Leffler, William N. Joy, and Robert 
S. Fabry, in UPM for 4.2 BSD, vol- 
ume 2C. (Also available as UCB 
CSRG TR/6.) 

[Leffler, Karels, and McKusick] 
‘Measuring and Improving the Per- 
formance of 4.2 BSD,” by Sam 
Leffler, Mike Karels, and M. Kirk 
McKusick, in USENIXY 1984 Sum- 


Dr. Dobb’s Journal, December 1984 


mer Conference Proceedings, 1984. 
(See [USENIX Summer’84].) 

[ Lesk and Schmidt] ““LEX—A Lexical 
Analyzer Generator” (1978), by 
Michael E. Lesk and Eric Schmidt, 
in UPM, volume 2. 

[Lions76] ‘‘Unix Operating System 
Source Code, Level Six” (1976), as- 
sembled by John Lions, School of 
Electrical Engineering, University 
of New South Wales. 

[Lions77] ‘““A Commentary on the 
Unix Operating System” (1977), by 
John Lions, School of Electrical En- 
gineering, University of New South 
Wales. 

[Lions78] ‘“‘An Operating System 
Case Study” (1978), by John Lions 
in Operating Systems Review, July 
1978, volume 12, number 3. 

[McGilton and Morgan] Jntroducing 
the Unix System, by Henry McGil- 
ton and Rachel Morgan, McGraw- 
Hill, 1983. 

[McIlroy] “Development of a Spelling 
List” (1982), by M. Doug Mcllroy, 
in JEEE Transactions on Communi- 
cations, January 1982. 

[McIlroy and Hunt] “An Algorithm 
for Differential File Comparison” 
(1976), by M. Doug Mcllroy and J. 
Wayne Hunt, CSTR, number 40 
(412). (Unfortunately, this is obso- 
lete and no longer available from 
AT&T.) 

[McKusick, Joy, Leffler, and Fabry] 
“A Fast File System for Unix” (July 
27, 1983), by Marshall Kirk McKu- 
sick, William N. Joy, Samuel J. 
Leffler, and Robert S. Fabry, in the 
UPM for 4.2 BSD, volume 2C. (Also 
available as CSRG TR/7.) 

[McNamara, Vaish, and Bryant] 
“Writing Device Drivers for XENIX 
Systems,” by Jean McNamara, Par- 
esh Vaish, and Richard N. Bryant, 
in UniForum Conference Proceed- 
ings, January 1984. 

[Morris and Cherry] “DC—An Inter- 
active Desk Calculator” (November 
15, 1978), by Robert Morris and 
Lorinda L. Cherry, in UPM, volume 
2i 

[| Nowitz] “UUCP Implementation De- 
scription.” iL19787)) by -D.- A. 
Nowitz, in UPM, volume 2 (of most 
manuals). 

[ Nowitz and Lesk] “A Dial-Up Net- 
work of Unix Systems” (1978), by 
D. A. Nowitz and M. E. Lesk, in 


Dr. Dobb’s Journal, December 1984 


UPM, volume 2 (of most manuals). 

[Nystrom] Writing Unix Device Driv- 
ers, by Bob Nystrom, International 
Technical Seminars, 1984. (Re- 
quires a Unix source license; only 
available by taking the seminar?) 

[Pammett] “A Compiler for the Sys- 
tems Programming Language—C”’ 
(Master’s thesis, 1979), by Kevin G. 
Pammett, Department of Computer 
Science, University of Waterloo. 

[Peterson] “Computer Programs for 
Detecting and Correcting Spelling 
Errors” (1980), by James L. Peter- 
son, in Communications of the 
ACM, December 1980, volume 23, 
number 12. 

[Ritchie76] “A Tour through the Unix 
C Compiler” (19767), by Dennis M. 
Ritchie,in UPM, volume 2. 

[Ritchie78] “The Unix I/O System” 
(1978), by Dennis M. Ritchie, in 
UPM, volume 2. 

[Ritchie79] ‘“‘The Evolution of the 
Unix Timesharing System” (Sep- 
tember 1979), by Dennis M. Rit- 
chie, presented at the Symposium on 
Language Design and Programming 
Methodology in Sidney, Australia, 
reprinted in Microsystems, October 
1984, volume 5, number 10. 

[Ritchie and Thompson] “The Unix 
Time-Sharing System” (1978), by 
Dennis M. Ritchie and Ken Thomp- 
son, in BSTJ, July/August 1978, 
and UPM, volume 2, of most 
manuals. 

[Schreiner] “‘p—A Small-C Preproces- 
sor’ (1984), by Axel T. Schreiner, 
in Dr. Dobb’s Journal, July 1984, 
number 93. 

[Thomas and Yates] A User Guide to 
the Unix System, by Rebecca 
Thomas and Jean Yates, Osborne/ 
McGraw- Hill, 1982. 

[Thompson] “Unix Implementation” 
(1978), by Ken Thompson, in BSTJ, 
July/August 1978, and UPM, vol- 
ume 2. 

[USENIX Summer’84] USENLX 1984 
Summer Conference Proceedings, 
USENIX Association and the Soft- 
ware Tools Users Group, June 12- 
15, 1984, in Salt Lake City. 

[Vaish and McNamara] “Techniques 
for Debugging XENIX Device Driv- 
ers” (1984), by Paresh K. Vaish and 
Jean Marie McNamara, in USENILX 
1984 Summer Conference Proceed- 
ings, 1984. (See [USENIX Summer 


"84].) 

[Wales] “Re: ‘panic: iput’ message” 
(October 19, 1983), by Rich Wales 
(wales@UCLA-LOCUS.ARPA), 
message number 12791 @sri-ar- 
pa.UUCP on Usenet. 

[Whale] “‘fgrep.c—new version” (Au- 
gust 8, 1984), by Geoff Whale 
(goeff@elecvax.OZ), message num- 
ber 296@elecvax.OZ on Usenet. 


DD) 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 194. 


Graphs without 
Graphics? 


No need for screen graphics. Publishable 


graphs on your dot matrix printer. 


Easy to Use. No programming. 
CP/M 80 or 86, MS-DOS, or PC-DOS. 
Excellent Manual. Most disk formats. 


Data Plotter ”™ 


-O3 THEORETICAL 


xxx EWP RTE AL 





OISPLACEMENT 





MILLISECONDS 


Line Graphs & 


-.7 


S $69 Shipping... ... add $3 
catterplots. . Outsi 4 
Software ™ Bar Graphs & cee o .... add $6 
7 Cedars Road Pie Charts. . .$69 Specify which Printer 
Both for .... sede 
Caldwell, NJ 07006 Both for. -- $99 o91) 226-7552 


Circle no. 57 on reader service card. 


SMALL-C 2.0 


for 


THE IBM PERSONAL COMPUTER 
and 
MS-DOS COMPATIBLE SYSTEMS 


A large subset of C, packed from argc to 
xtoi () with features, including 


1/0 redirection, compilation by parts, peephole optimization, 
assembly language interface, conditional compilation, 
switch/case/default, command line support, completion codes, 
initialization of global variables, data types-char, int, 

pointers, one-dimensional arrays, and externals 


Complete source code for the compiler and 
libraries plus a 22 page user manual are 
included. 


Requires: 
IBM PC assembler, ASM.EXE, or equivalent 
IBM PC-DOS 2.0, 2.1 or MS-DOS 2.0 
96K memory and a SS Disk Drive 


Send $35 check or money order to 


The Coriolis Company 

P.O. Box 76 

Clinton Corners, NY 12514 

(NY residents please add 5% for sales tax.) 


Executes sieve benchmark in 35 seconds! 





Circle no. 26 on reader service card. 


59 


A File Browser Program 


by John R. Johnson 


60 


asting about for a useful prob- 
( lem to exercise my new C com- 

piler, I heard about a useful pro- 
gram on a VAX system called “show.” 
This program is similar to the “type” 
intrinsic command in CP/M, but it al- 
lows you to move about at will in the file 
being displayed. I have often been irri- 
tated by “type” when I am looking for a 
line near the end of a large file and it 
scrolls past before I can stop the dis- 
play. It could be a useful utility. 

Browse is essentially the front end of 
a simple editor program. Since it will 
not change the file, but only display it, 
a line orientation is adequate. To make 
moving around easier, the lines in the 
display should be numbered. 

A simple command line parser is re- 
quired to make the program useful. The 
ability to repeat a command a set num- 
ber of times is a desirable option. The 
parser should accept numeric argu- 
ments for either repeat count or line 
number, depending on the command 
function. 


reading in the file. Should the file be 
buffered on disk or kept entirely in 
memory? If it is kept in memory the 
random access display would be quick. 
Response time would suffer with a disk 
buffer. The trade-off is file size. If it is 
kept entirely in memory the file must 
be short enough to fit or it will be 
truncated. 

If the file browser has a slow re- 
sponse there is no real reason to use it 
rather than the editor to examine a file. 
Any editor will allow most of the func- 
tions of the browser. Since it is used pri- 
marily for looking over program source 
code, and I believe programs should be 
kept as short as possible, I opted for 
speed. Browse will arbitrarily chop the 
end off of any file that is too long to fit 
in the available memory. 

The hardware-dependent features 
are severely restricted. Direct cursor 
addressing is specifically not required. 
A string that clears the screen and 
homes the cursor is used. If your termi- 
nal does not support this feature, lo- 





Power can be superfluous and features can just be 
in the way when all you want is the right tool for 
the task. 





There are existing utilities to list 
files on the printer. A list option in a 
file browser would be worth including 
only for those cases where hard copy is 
desired for only a few lines. If this 
could be included it would be worth 
doing. 

The most difficult decision involved 


John Johnson, 413 West Sycamore, 
Carbondale, IL 62901. 


cate each instance of the #define con- 
stant CLEARS, and replace the call 
puts(CLEARS) with a call to a func- 
tion to write a screen full of blanks. 
Edit the file Browse.h to set the screen 
and printer page sizes to correspond 
with your hardware, and that should 
be all of the installation required. 

I do not recommend using I/O redi- 
rection with this program. It would put 
quite a lot of junk into an output file. A 
minor modification to the list function 
could allow listing selected portions of 
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the program to an output file. This 
could be useful if your editor allows 
you to read in only complete files. You 
could use Browse to pull a function or 
two out of a larger file so you could 
incorporate them into a different pro- 
gram. I chose not to include this capa- 
bility. It is not useful with my editor. 

The various functions in the pro- 
gram are quite straightforward. I have 
tried to put adequate comments into 
the source to define each of them. 

Browse recognizes several com- 
mands for moving around in the file 
being examined. These commands are 
explained with the required syntax in 
| the function help(), which is the last 
function in the source listing. (See the 
table on page 61 for a list of the Browse 
commands.) Additional commands 
could be added by writing the appro- 
priate functions to execute them and 
adding the command character into 
the if ... else if ... string in the function 
command(...). A useful command to 
add would be a string search capabili- 
ty. This could be patterned after the 
grep function in the book Software 
Tools, which should be in every serious 
programmer’s library. 

At this point in the development, 
discretion forced a halt before a simple 
file browser turned into a full-fledged 
editor. The listing accompanying this 
article (page 62) was created to be 
compiled under BDS C version 1.50a. 
It should convert easily to other C 
compilers or to other versions of BDS 
ae 
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The following is a brief listing of the commands for Browse. The 
information may also be found in a help screen (at the end of the 
program listing), which is available to the user on-line. <n> repre- 
sents any positive integer. 


Command 
<n> 
<n>u 
<n>d 


Result 


b 


Redisplay beginning of file 


e 


S12 


<n>n 
<n>p 


q 


ant <n I 


Redisplay with line <n> in the center 
Go up <n> lines and redisplay 
Go down <n> lines and redisplay 


Redisplay end of file or buffer 


Reset tab stops to every <n> spaces and redis- 


play the screen; tab stops default to every four 
spaces if not set 


Go down <n> pages (default is one) 
Go up <n> pages (default is one) 


Quit and return to operating system 


List file from <n1> to <n2> on the system list 


device (line printer) 


Table 


Once you choose Lattice, 
our friends will C you through... 


LATTICE INC.: LATTICE WINDOWS, 
CURSES UNIX SCREEN CONTROL LIBRARY, 
C-FOOD SMORGASBORD, . dB-C_ ISAM | 
COMPATIBLE WITH dBASE II AND 

ll... LIFEBOAT ASSOCI- 

ATES: FLOAT 87 8087 SUPPORT 

PACKAGE, HALO GRAPHICS 

PACKAGE, PANEL SCREEN LI- 

BRARY... GREENLEAF SOFT- 

WARE: THE GREENLEAF C 
FUNCTIONS... C SOURCE: 

BASIC_C C FUNCTIONS FOR BA- 

SIC USER... SOFTCRAFT: 

BTRIEVE ISAM FILE SYSTEM, 

3TRIEVE ISAM NETWORK FILE 

SYSTEM ... BLAISE COMPUT- 

ING: TOOLS, TOOLS2, VIEW 

MANAGER SCREEN _ PACK- 

AGE . MORNING — STAR 

SYSTEMS: PROLIBRARY, PRO 

SCREEN ... CREATIVE SOLUTIONS: 
WINDOWS FOR C....NOVUM 
ORGANUM: C POWERS PACKS, MATH- 
=MATICS POWER PACKS, ADVANCED POWER 
PACKS, DATABASE POWER PACKS,  TELE- 
COMMUNICATIONS POWER = PACKS W/ 
SOURCE... PHACT ASSOCIATES: PHACT 
‘SAM LIBRARY... RAIMA CORPORATION: 


db_ VISTA DBMS... PHOENIX: 
PLINK86, PFIX86... RELATION- 
AL DATABASE SYSTEMS: c- 
ae FILE ACCESS METH- 
. MINDBANK: V-FILE 
VIRTUAL MEMORY/FILE SYS- 
TEM... HUNTER & 
READY: VRTX C INTERFACE 
LIBRARY . 
SOFTWARE 
GSS DRIVERS, GSS TOOLKIT 
KERNEL SYSTEM. OPT- 
TECH DATA PROCESS- 
ING: OPT-TECH SORT. 
ACCUDATA SOFTWARE: 
C-TREE ISAM, 
SORT... TRIO SYSTEMS: 
C-INDEX + ISAM . 
COMPU CRAFT: c VIEW 
FORMS/WINDOW MANAGE- 
MENT... SCIENTIFIC ENDEAVORS: 
GRAPHIC PRESENTATION = SCIENTIFIC 
GRAPHICS... LEMMA _ SYSTEMS, 
INC.: C LIBRARY... ESSENTIAL SOFTWARE, 
INC.: C UTILITY LIBRARY... SQFTWARE 
LABS: C UTILITIES PACKAGE .. . FAIRCOM: C- 
tree BY FAIRCOM ISAM WITH SOURCE 


Contact Lattice to learn how we can help your C program development. 


fal LATTICE 


P.O. Box 3072 
Glen Ellyn, IL 60138 
312/858-7950 

TWX 910-291-2190 
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F, ile Br owser Listing (Text begins on page 60) 
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Program Browse.c 
by John R. Johnson 
Version 1.01 Dec 7, 1983 


Copyright 1983 

by John R. Johnson 

All rights reserved. 
Permission is granted for 
unlimited personal, 
non-commercial use only. 


Address queries to: 


John R. Johnson 
Professional Microware, Inc. 
YP. Oe BOX 200 

Carbondale, Illinois, 629983 


Reasonable telephone queries 
will be answered if you call 
at 618-529-2717. ‘Make sure 
the time is between 9 AM and 
5 PM Central time. 

I regret that 2 cannot -return 
long distance calls except 
collect. Thank You. 


#include <bdscio.h> 


/* Leor Zolman's definitions */ 


#include <browse.h> 


/* browse definitions */ 


main (argc,argv) 
int argc; 
char **argv; 


/* 
* 
* 


int tabstop; 

/* tab stops for display */ 

int lincnt; 

/* number of lines in buffer */ 
int offset; 

/* window width / 2 */ 

int *curlin: 


active line number 
( center of window ) 


ae 


int *lines; 
char *max; 


/* 


* 


+ + + + + OF OF F 


b2) 
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array of pointers to strings. 
This array is the line index 
for the file. max is the 
maximum useable address for 
buffer. The buffer is 
allocated but not accessible 
except through this array. 
The array lines[lincnt] is a 
trick to get an array of 


* dynamically assigned length. 
* It is located by makbuf () 

* and created by filbuff( ). 
ef 


Char inbuf[BUFSIZ] ; 

/* file input buffer */ 
char filename[18] ; 

/* filename buffer */ 
Char cline[135]; 

/* command line buffer */ 


puts (CLEARS) ; 

printf("\nBROWSE copyright ") ; 
print£("1983 by John R."); 
printf(" Johnson\n") ; 


tabstop=4; 
/* default value for tabs */ 


/* 
* get the file name, if it is 
* not given on the command 
* line prompt the user. 


+7 


if. (Cargcery. ee 
(strlen(argv[1])<18)) 


Sstrcpy(filename, argv[1l]); 


else 


{ 
while(1) 
{ 


puts("Enter file name > "); 
if (getline(filename, 18) ) 
break; 


j 
/* 


* open the file requested 


ag 
if (fopen(filename, inbuf) ==ERROR) 
{ 


error("\nfile $s not found" 
,Lilename) ; 
exit(); 


/* 
* create the arrays 


ef 


lines = makebuf (&max) ; 
if (lines==@) 


error("\ncouldn't create 
buffer for %s",filename) ; 

fclose(inbuf) ; 

exit(); 
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/* 
* read the file into the arrays 


eS 


if ((lincnt= 
Fillbuf(lines,max,inbuf)) == @) 


error("\ntrouble reading $s", 
filename) ; 

fclose(inbuf) ; 

exit(); 


/* 
* close the file so we don't 


* do anything to it. 
ny. 


fclose(inbuf) ; 


/* 
* initialize the display 
ef g 


offset = setoff(); 
Curlin = offset; 
/* 


* display the screen and parse 
* and interpret commands. 

* Notice the next current line 
* is returned from the command 
* parse routine. 


while((curlin=command(filename, 
curlin,cline,offset,lines, 
lincnt,&tabstop) ) ) 


=e 


/* 
* clear the screen 
*/ 


puts (CLEARS) ; 
} /* end of the main function */ 
/* special functions used */ 
int error(format, arg) 
Char *format, *arg; 
ring the bell and print an 


error message formatted as 
for the printf function. 


+ +e + + SF HF 
a oe 


int error(format,arg) 
Char *format,;*arg: 


{ 
puts (BELL) ; 


printf£(format,arg) ; 
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re ee 


/* 
* 
* 


* 


int setoff() 


set the display offset 


*/. 
int setoff() 
{ 


he 
a 
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return ((SCRHT-1)/2) ; 


display(keylin, offset, lines, 

Last, tab, -£) 
int keylin, offset, lines[]; 
int last, tab, £; 


display offset lines before and 
after the current line. Stop 
when screen is full and wait 
for further commands. Do not 
alter the display if current 
line if negative. A negative 
value is used to keep from 
Writing over the help screen 
when it is displayed. 


+ 
~*~ 


display(keylin,offset,lines,last, 


tab, f£) 


int keylin,offset,lines[],last,tab; 
char *£; 


{ 


int j, lone, ltwo; 


/* 
* if current line is negative, 
* omit display update 
ay 


if (keylin<®@) 
return; 


/* 


* don't try to display more 

* lines than there are. 

* 

if ((keylintoffset) >last) 
keylin=last-offset; 


/* 
* don't try to display before 
* the beginning of the file. 
* 


if ((keylin-offset) <@) 
keylin=offset; 


/ 


* 
* if the entire file fits on 

* the screen, just display the 
* entire file. Otherwise just 
* display what fits, so it the 
* current line stays in the 

* middle of the screen. 

* 

£ 


(last<(offsettoffset+l) ) 
(Continued on page 66) 
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Lifeboat Is The Source. 





Tie = 
The Leading Source And Authority For Serious ee 
1-800-847-7078. 


In NY State: 21 2-860-0300 


; NY 


Serious Software For The C Programmer From Lifeboat... 


Lattice" C Compiler: The serious software developer’s first choice. 


Selected for use by IBM," Texas Instruments, Wang," MicroPro," Ashton-Tate, ~ 
IUS/Sorcim," Microsoft" and Lotus” to name a few of the many. Why? 
Lattice C 1s clearly the finest 16 bit C compiler available today. 
— Renowned for speed and code quality. 
—Fully compatible with the C standards set forth by Kernighan and Ritchie. 
—Four memory model options offer you unsurpassed control and versatility. 
—Superior quality documentation. 
—Now includes automatic sensing and use of the 8087 chip. 
— Widest selection of supporting add-on packages. 


Haio'’: A graphics development package rapidly emerging as the industry standard. 


—140 graphics commands including plot, line, arc, box circle and ellipse primitives, 
bar and pie charts; pattern fill and dithering commands. 
—New: multiple viewports and “‘stroke text” for angling, scaling and filling text. 


C Food Smorgasbord'’’: This beautifully written collection of C functions is a valuable time saver. 


—Library includes a binary coded decimal arithmetic package, level 0 I/O functions, 
a terminal independence package, IBM PC ROM BIOS access functions and much more. 


Pmate’’: The premier editor for the programming professional. 


Pmate is a full screen editor with its own powerful macro command language: 
—Perform on screen row and column arithmetic, alphabetize lists, 
translate code from one language to another, call up other macros. 
—Customize Pmate almost any way you like. 
—Contains 10 auxiliary buffers for storage of macros, text, subroutines. 
—An “‘undo”’ feature allows the programmer to retrieve whole series of deleted items. 


Additional C Tools Panel'”: Screen formatter and data entry aid. 

Available From Lifeboat: Lattice Windows'": Windowing utility; create ‘‘Virtual Screens.” 
Plink-86'": The popular linker; includes extensive overlay capabilities. 
Pfix86 ": Dynamic debugging utility. 
Pfix86 Plus “: Symbolic debugger with capacity to debug overlays. 
Btrieve ': Database record access/retrieval library. 
Phact: Multikeyed ISAM C-Function lbrary. 
Fabs: Fast access B-tree database function library. 
Autosort: Fast sort/merge utlity. 
ES/P: ‘C’ program entry with automatic syntax checking and formatting. 
Greenleaf Functions'”: Library of over 200 popular C functions. 

And much more. 


| YES! Please rush me the latest FREE Lifeboati« catalog of C products. 
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Please check the category where Lifeboat can best help you: 
[ | Software development |_| Corporate | | Education 
|} Dealer/distributor |_| Government |_| Other 
Call Direct: 1-800-847-7078 (In NY State: 212-860-0300) 
Return coupon to: Lifeboat Associates: 
| 1651 Third Avenue, New York, NY 10128. 
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lone=@; 
ltwo=last; 


else 


lone=keylin-offset; 
ltwo=keylintoffset; 


/* 
* do the display of the 
* lines we chose and then 
* print the file name at the 
* bottom of the screen. 
*/ 
puts (CLEARS) ; 
for (j=lone;j<(ltwo) ;++)j) 
outlin(j,lines[j],tab) ; 
Pranic Crises fe 5" 72) 3 


Rit: Ay ts 
char *str;3 


output a line to the terminal 
expanding tabs by t. To take 
care of terminals with fixed 
tab stops. Truncate displayed 
line to screen width to prevent 
uncontrolled scrolls. 


+ tb FF OH OF OF OF 


* 
i 


int. outtin(n,str,t) 
grt Wets 
Char *str; 
{ 
char cs 
int “colk;sk; 


k=0; 
printt ("43ds",n}- 
/* print the line number */ 


/* 
* now output the line 
off 
for (col=5;col<(SCRWID-6) ;) 
{ 
/* 
* expand tabs for terminals 
* that don't support tab 
* setting to any widths. 
es 
if ((c=str[k++])=='"\t') 
{ 
do 
/* at least one blank */ 
66 
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* 
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putcnart'... 7); 
colt++: 
} while((col%t) && 
(col< (SCRWID-6) )); 
} 


/* 
* quit at the new line 
¥/ 
else if ( c=='\n' ) 


break: 


/* 
* for all others, 


* just put the char 
sf 


else 

{ 
putchar(c) ; 
colt++ts; 


} 


* 


* always end with a new line 
ee 


putchar('\n'); 


int makebuf (pmax) 
char **pmax; 


allocate all of free memory for 
a buffer for the lines array 
and the text buffer. Arg is a 
pointer to max so that max can 
be set to the last available 
memory location. Return the 
pointer gotten from alloc(...) 
for the value of lines. 


int makebuf (pmax) 
char **pmax; 


{ 


char *here; 
unsigned templ,temp2; 


templ=endext() ; 
/* first memory location */ 
temp2=topofmem() -30900; 


/* last free memory */ 
here=alloc(temp2-templ) ; 
/* allocate it */ 

if (here==@) 


(Continued on page 68) 
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C Programmers: 








with Instant-C™ 


Instant-C™ is an optimizing interpreter for C that 
_ | makes programming three or more times faster. It 
eliminates the time wasted by compilers. Many 
repetitive tasks are automated to make program- 
} ming less tedious. 


M@ Iwo seconds elapsed time from completion of 
editing to execution. 


@ Symbolic debugging; single step by statement. 


H Compiled execution speed; 40 times faster than 
interpreted Basic. 


z Full-screen editor integrated with compiler; 
compile errors set cursor to trouble spot. 


@ Directly generates .EXE or .CMD files. 


@ Follows K & R—works with existing programs. 
Comprehensive standard C library with source. 


@ Integrated package; nothing else needed. 
MM Works under PC-DOS*, MS-DOS*, CP/M-86*. 


More productivity, less frustration, better programs. 
Instant-C™ is $500. Call or write for more info. 


Rational (617) 653-6194 


3 P.O. Box 480 
Systems, Inc. Natick, Mass. 01760 


Trademarks: MS-DOS (Microsoft Corp.), PC-DOS (IBM), CP/M-86 (Digital Research, 
Inc.), Instant-C (Rational Systems, Inc.) 
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delivered monthly to the doorstep, and 
save $5 off the newsstand price. 
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$13! 


Every month, you'll find articles on Smalll-C, 
FORTH, CP/M, S-100, Compiler optimization, 
Concurrent Programming and more. 
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Turbo + PC Tools = Programs 
Tools for Turbo Pascal™ on the IBM PC 


Window Management = menus, help files. . . 
e Unlimited windows e Window overlay & recall 
e Cursor save & jump e Access all colors & chars 
¢ Window Compiler/Librarian manages window files 


Graphics Drawing = HiRes plotting power! 
e Ellipses, polygons & more —  ® Region fill and clear 


String Formula Evaluator = easy calculation 
e 22 functions with nesting and implicit multiplication 
e Won’t bomb on overflow or division by zero 


System Check and Control = max flexibility! 
e Time & date access e Get disk types & room 
e Get & set default drive e 1/0 information 


- All this for only $39.95*. . . Incredible! 


You get 321K of source code on a double-sided disk 
and a 35 page manual. For single-sided drives add $2. 
Works with DOS 2.0, Turbo 2.0. 


Paragon Courseware 
4954 Sun Valley Road 
($4 if outside of USA). Del Mar, CA 92014 


*Please include $2 for 
postage and handling 


Californians add 6%. (619) 481-1477 


Turbo Pascal is a trademark of Borland International 


Circle no. 69 on reader service card. 


Yes! Please start a subscription for 
a yn $25 - ae aes toe 
















Name 
Address 


Zip 
_____ Charge my Visa, MasterCard, 


Please bill me later 
| enclose a check/money order 








Name 
Address 

Zip 
Credit Card Exp. date 
Account No. 


Signature 


Circle no. 128 on reader service card. 
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return (@); 
*pmax = temp2; 
return (here); 


os 
+ 


int fillbuf(lines, max, inbuf) 
int lines[]; 

char *max; 

struct .but *“inbut: 


Fill the string arrays allocated 
by makbuf(). As each line is 
placed into the text buffer, 
enter the corresponding pointer 
into the array lines[]. Notice 
the text buffer builds down from 
top of free memory while the 
array lines[] builds up from the 
bottom. Filling stops on end of 
file or when the array meets the 
text buffer. 

Return the number of lines read. 


+ Ft et Fe FH eH eH HF HF HF HF HH HF HF OH F 


+ 
ing 


int fillbuf(lines,max,inbuf) 
int lines[]; 

char *max; 

struct _buf *inbuf; 


int count; 

/* line counter */ 

char *bufptr,*buflin; 
/* buffer ptrs */ 

char tbuf[100]; 

/* temp input buffer */ 


bufptr = max; 
/* start of buffer */ 


*hutptre—. = *\Gl 
/* put in the null */ 
*bufptr-- = '\O'; 


buflin = bufptr - 8; 


if (lines > buflin) 
return (0); 
strcpy(buflin,"<Start>\n") ; 
lines[@] = buflin; 
bufptr = buflin; 
count=1; 
while (&lines[count] < bufptr) 
/* 
* get a line into the buffer 
* and place the pointer in 
* lines[] array for access. 
* 


if (fgets(tbuf, inbuf) ) 
{ 


buflin = bufptr - 
strlen(tbuf) - 1; 
if (&lines[count] > buflin) 
break; 
r==DULpET =." ¥eh; 
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lines[count] = buflin; 
bufptr = buflin; 
Sstrepy(buflin, tbuf) ; 


countt+t; 
} 
else 
{ 

break; 


} 
buflin = bufptr - 8; 
if (&lines[count] < buflin) 


{ 
/* 
* put on the end of file 
* marker if we got there. 


Ff 


strcpy (buflin,"<End>\n") ; 
lines[count] = buflin; 
*¥-—buLptr = A8"s 
ee —Sur pty SAG es 
++count; 

} 


return (count); 


int command(f, active, cmd, 
offset, lines, lincnt, t) 

int active, offset, lines[]; 

int. Linent,...*t 

char cmd, *f£; 


command interpreter and display 
handler. Parses the command 
line and executes the correct 
function to execute the command. 
Additional commands can be added 
into the if .«.. @ise if... else 
construction in the parser. 


uff 


int command(f,active,cmd,offset, 


lines,lincnt,t) 


int active,offset,lines[]; 
int lincnt,*t; 
char cmd[],*f; 


int length,first,second,temp; 
char key; 


display(active,offset,lines, 
FINCH, *C, IP} 


* 


* If display is suppressed, 

* then activate it. 

af 

if (active<@) 
active=-(active) ; 


(Continued on page 70) 
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Release 3.0 


We think Rel. 3.0 of the Eco-C Compiler is the 
fastest full C available for the Z80 environment. 
Consider the evidence: 


Benchmarks* 
(Seconds) 
















Benchmark Q/C 











CNC - Could Not Compile 
N/A - Does not support floating point 


We've also expanded the library (120 func- 
tions), the user's manual and compile-time 
switches (including multiple non-fatal error 
-messages). The price is still $250.00 and 
includes Microsoft's MACRO 80. As an option, 
we will supply Eco-C with the SLR Systems 
assembler - linker - librarian for $295.00 (up to 
Six times faster than MACRO 80). 


For additional information, 
call or write: » 


EG (317) 255-6476 


6413 N. College Ave. @ Indianapolis, Indiana 46220 






















Circle no. 35 on reader service card. 


“Ouvrez les 


977% 


fenetres! 


Introducing MATIS. the powerful new 
developmental system from France. 
A complete and meticulously detailed program 
to make a programmer's work easier, faster, and... 
but of course... better. 















[_] Window Management Systems ‘J Screen Generator 1 Expanded 
Basic Commands L] Can be accessed from other languages [] 100% 
Assembler [] Automatic Scrolling in Windows (] Virtual Page larger 
than screen (up to 65534 rows x 65534 columns) L] Save or Print 
Pages L] MS-DOS (J 170 Page Manual (In English Mon Ami!) 

[_} Only $150. 


ORDER BY MAIL—WRITE OR CALL FOR COMPLETE DESCRIPTION 
No license fee. 


Softway, Inc. 


500 Sutter Street * Suite 222— M « San Francisco, CA 94102 
Tel: (415) 397-4666 Telex: 880857 


¥“Open the windows! 
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Eco-C Compiler ~ Of cours 


POWER! saves 
your Bad Disk. 















NOW! WINDOWS FOR IBM! 


It also AC , 
24 other things t 
keep your disk in line. 


EVERYTHING YOU ALWAYS WANTED 
TO DO, BUT WERE AFRAID TO TRY 


Unlike some utility programs that area headache _ 


touse, POWER! is engineered to spoil you with 55 
features, simple and uniform commands, and utter 
simplicity of use. POWER! automatically alpha- 
betizes and numbers your files. You select by the 
number and never type file names again. Need to © 
[COPY], [RENAME], [ERASE], or [RUN] programs? Just 
type in their menu number! POWER! also locks 
out your disk’s bad sectors [TEST] without destroy- 
ing files—a critical difference from other utilities 
that search and destroy, without informing you 
what they’ve done, leaving you to wonder why 
your programs won't run. (And POWER! still has 
90 commands to go!) 


POWER! ONE PROGRAM DOES IT ALL! 


You may own a few utility programs for your com- 
puter housekeeping, each with its own commands 
to memorize. POWER! has all the programs rolled 
into one 16K integrated package, so you do things 
you've never tried before—every day. Save sen- 
sitive data from prying eyes with [PASS] word pro- 
tect, move a block of memory [MOVE], look for data 
[SEARCH] or compare files [CHECK]. POWER! also 
makes easy work of patching, [DISPLAY/SUBSTITUTE], 
customizing software [LOAD/SAVE]. Among the 
other commands are [SIZE], [Stat] [LOG], [DUMP], 
[TYPE], [JUMP], [FILL], [SET], and the CP/M version 
lets you restore erased files—even when you don’t 
remember the filename—at a flick of the POWER! 
[RECLAIM] command. (Still 31 commands to go!) 


POWER! NOW FOR IBM's PC-DOS 
AS WELL AS CP/M 


We first developed POWER! for CP/M two years 
ago, and a stack of testimonials from FORD to 
XEROX testify to its excellence. For IBM-PC™ 
users, special features like managing sub-direc- 
tories, [CHANGE], and a separate creation of up to 


8 simultaneous, on-screen [WINDOWS] have been — _ 


added. 


MONEY-BACK GUARANTEE AND 
A 10 DAY TRIAL 


POWER! has the Seal of Approval from the Pro- 


fessional Software Programmers Association, and 


you, too, must be happy with POWER!-—or your 
money back! For only $169 you can now really be in 
control of your computer. Call Computing! at (415) 
067-1634, or your local dealer. For IBM-PC or any 
CP/M machine. Please specify disk format. 


a er ae 


COMPUTING! 


2519H Greenwich, San Francisco, CA 94123 


TO ORDER CALL 800 TOLLFREE 


800-428-7825 Extension 96H 
In CA: 800-428-7824 Extension 96H 


IBM and IBM-PC are registered trademarks of 
International Business Machines Corporation. 





li 


| 
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/* get a command line */ 
length=getline(cmd, 132); 


/* 
* if command line is null, 
* then do nothing more. 
a 
if (length == 9) 
return (active) ; 


/* 
* Set the key to the first 


* alpha in command. 
* 


key=letter(cmd,length) ; 

/* 
* Get up to two numbers from 
* the command line. 
* 


first=numone(cmd,length) ; 
second=numtwo(cmd,length) ; 


/* 


* No key found means first is 


* the desired current line. 
* 


if (key == 8) 
{ 


if (first<offset) 
return (offset) ; 
if ((f£irsttoffset) >lincnt) 
return (lincnt-offset) ; 
return (first); 


/* 
* force the key to lower caSe. 
* 


key = tolower (Key); 
/* 


* if key is u 
* move up n lines. 
* (default 1) 
af A 
1f (key == ‘'u') 
{ 


if. CEieet) 
{ 


if ((active-first) 
< offset) 
return (offset) ; 
else 
return (active-first) ; 


j 


else 


{ 
if (active > offset) 
return (--active) ; 


else 
return (offset) ; 
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* 


* if Key is ad 
* move down n lines. 
* (default 1) 


“7 


if (key == 
{ 


'q') 


if thirst) 
{ 


if tlactivetFfirst) 3 
(lincnt-offset) ) 
return (lincnt-offset) ; 


€ 


} 


else 


{ 


lse 


return (activetfirst) ; 


1f (active < 
(lincnt-offset) ) 
return (++active) ; 


e 


/* 


lse 


return (lincnt-offset) ; 


*-32L Key. 18"5 
* move to beginning of file. 


* 


if (key 


"op 


return (offset); 


/* 


* if key is e 
* move to end of file. 


“/ 
if (key 


Te!) 


return (lincnt-offset) ; 


/* 


* 22 fey 48. 0 
* set tabs to n (default 4) 


st 


if (key == 't') 


{ 


if ((first<=0) || (first>29) ) 
first=4; 

*t=first; 

return (active); 


} 
/* 


* LE key ecb 

* n'th previous page. 
* (default 1) 

* 


if (ke 
{ 


“ot 


(Continued on page 72) 
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Cc 
UTILITY LIBRARY 


| The C UTILITY LIBRARY is a set of 200+ functions designed 
|| specifically for the PC software developer. Use of the Library will 
Speed up your development efforts and improve the quality of 
your work. 


e BEST SCREEN HANDLING AVAILABLE 


e WINDOW MANAGEMENT,COLOR GRAPHICS 
e DOS 2 DIRECTORIES, COMMUNICATIONS 


e KEYBOARD, PRINTER, TIME/DATE 

e EXECUTE PROGRAMS, BATCH FILES 

e STRINGS, BIOS, AND MUCH MORE 

e ALL SOURCE INCLUDED—NO ROYALTIES 


# Available for Microsoft/Lattice $149, Computer Innovations 
$149, Mark Williams $149, DeSmet $99. Add $3 shipping. N.J. 
residents add 6% sales tax. Visa, MC, checks—10 days to clear. 


Order direct or through your dealer. Dealer/Distributor inquiries 
welcome. 
ESSENTIAL SOFTWARE, INC. 
(914) 762-6605 
PO. Box 1003 
Maplewood, N.J. 07040 


Circle no. 36 on reader service card. 


$3.00 C 
Compiler 


Due to popular demand Dr. Dobb’s Journal has reprinted Ron 
Cain’s C compiler from our sold-out 1980 issues #45 and #48. 
The reprint includes “A Small C Compiler for the 8080s” and 








“Runtime Library for the Small C Compiler” for only $3.00, 
postage included. To Order: 


Enclose $3.00 for each copy with this coupon and send to: 
Dr. Dobb’s Journal, 2464 Embarcadero Way, 
Palo Alto, CA 94303. 


Please send 


copy(ies) to: 


address 


City state 


All reprint orders must be prepaid. 
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EC Source Code 


RED 


Full Screen Text Editor 


New 





Versions for IBM PC and Kaypro. 


Distributed on 5% disk formats. 


¢ RED is fast! RED uses all of your terminal’s 
special functions for best screen response. 
RED handles files as large as your disk 
automatically with a minimum of disk 
traffic. 


¢ RED is easy to use for writers or pro- 
grammers. It uses plain English commands. 


¢ RED comes with complete source code in 
standard C. You choose how your editor 
will work. RED’s code is truly portable: 
RED has been ported to mainframes, minis 
and micros. 


¢ RED comes with a Reference Card and a 
Reference Manual that provides everything 
you need to use RED immediately. 


¢ RED is unconditionally guaranteed. If for 
any reason you are not satisfied with RED 
your money will be refunded promptly. 


RED: $95 Manual: $10 


Call or write today for 
more information: 

| f Edward K. Ream 
edward k ream = 1850 Summit Avenue 
Madison, WI 53705 
(608) 231-2952 





To order: 


Either the BDS C compiler or the Aztec CII compiler is required for 
CP/M 80 systems. Digital Research C compiler v1.1 is required for 
CP/M 68K systems. No compiler is required for IBM or Kaypro 
systems. 


Specify both the machine desired (IBM, Kaypro or CP/M) and the disk 
format desired (8 inch single density CP/M or exact type of 54 inch 
disk). 


Send a check or money order for $95 ($105 U.S. for foreign orders). 
Serry, | do NOT accept phone, credit card, or COD orders. Please do 
not send purchase orders unless a check is included. Your order will be 
mailed to you within one week. 


Dealer inquiries invited. 
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} 
/* 


* 


BO (FFrst) 


if ((temp=2*offset*first) 
> active) 
return (offset) ; 
else 
return (active-temp) ; 


else 


if ((temp=2*offset) 
> active) 
return (offset); 
else 
return (active-temp) ; 


if key isn 


* n'th next page (default 1). 


th 


if 
{ 


* 
* 
* 


(key == ‘n') 


if -€First) 
{ 
temp=first* (offsettoffset) ; 
if ((activettemp) 
> (lincnt-offset) ) 
return (lincnt-offset) ; 
else 
return (activettemp) ; 


} 


else 
{ 
temp=offsettoffset; 
if ((activettemp) 
> (lincnt-offset) ) 
return (lincnt-offset) ; 
else 
return (activettemp) ; 


if key is q 
quit and exit to system. 


9 


if 


* 
* 
* 
* 
* 


if 
{ 
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(key == 'q') 
return (0); 


if key is l 
list from first to second 
lines on printer. 


(key == ‘l') 


lister(first, second, lincnt, lines, 
ae 
return (active); 


* 
* default, illegal command. 
ef 
/* 
* display help screen for 
* everything else. 
* 
help(); 
return -(active); 


os 
+ 


int letter(str,len) 
char *str:;: 
int len; 


returns the first alphabetic 
character in string str 


returns null if there are no 
alphas in the string. 


+e + He + F + 


/ 


char letter(str,len) 
char *str; 
int len; 


char ¢c,*cptr: 
Int es 


cptr=str; 
k=; 
while ((c=cptr[k++]) ) 
if (isalpha(c) ) 
break; 
return (c); 


} 
/* 
* numone(str, len) 
* Ghat Serr } 
* Int dens 
* 
* returns the integer value of 
* the first decimal digit string 
* encountered in string str. 
* Returns zero if no digit string 
*. 43 Eound,. 
ots 


int numone(str,len) 
Char *str; 
int len; 


char ec, *cptr;: 
Int. kK> 


cptr=str; 


k=; 
oe ((c=cptr[k])) 


(Continued on page 74) 
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The one and only adult Lisp system for CP/M users. 


aonrnoatan 


ex. aernecarr eanerranr 


aoc _ Waltz Lisp is a very powerful and complete implementa- 


0 2 ofxo Mo a 


_ tion of the Lisp programming language. It includes 






eee.” hi pieeee 2)" es L0G! AE features previously available only in large Lisp systems. In 
tp Bae ee - fact, Waltz is substantially compatible with Franz (the Lisp 

~ running under Unix), and is similar to MacLisp. Waltz is 

y perfect for Artificial Intelligence programming. It is also 


eonaaerr and 
RonasorxR08 





a2eaaIrF avaIAaar AaB > 


L most suitable for general applications. 







A Much foster than other microcomputer Lisps. ¢ Long integers (up to 611 digits). Selectable radix * True dynamic 


f° Binary files. * Standard CP/M devices. * Access to disk directories. ¢ Functions of type lambda (expr), nlambda 


loading of initialization file. ¢ Powerful CP/M command line parsing. * Fast sorting/merging using user defined 
comparison predicates. ® Full suite of mapping functions, iterators, etc. © Assembly language interface. * Over 250 
functions in total. © The best documentation ever produced for a micro Lisp (300+ full size pages, hundreds of 
illustrative examples). 














Waltz Lisp requires CP/M 2.2, Z80 and 48K RAM (more recommended). All common 5" 
Version 4.4 
(TM) (Now includes Tiny Prolog 


and 8'' disk formats available. 
written in Waltz Lisp.) 


RO ODE *Manual only: $30 (refundable with order). All 
foreign orders: add $5 for surface mail, $20 for 
ih S Stille beee airmail. COD add $3. Apple CP/M and hard sector 
15930 SW Colony PI. 


Sail agieed As formats add $15. 
t ’ 
sa re Call free T -800-LIP-4000 Dept. #11 


In Oregon and outside USA call 1-503-684-3000 





Unix" Bell Laboratories. 
CP/M”* Digital Research Corp. 
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AVAILABLE 


BACK ISSUES 


1982 1983 1984 
. 64—Feb. . /6—Feb. . 87—Jan. 
. 66—Arpril . 77—March . 88—Feb. 
. 68—June . 78—April . 89—March 
. 69—July . 79—May . 9O—April 
. JO—Audg. . 80—June. . 91—May 
. 71—Sept. . 81—July . 92—June 
. 72—Odt. . 82—Aug. . 93—July 
. 73—Nov. . 893—Sept . 94—Aug. 
. 84—Oct. . 95—Sept. 
. 85—Nov. . 96—Oct. 
. 86—Dec. . 97—Nov. 


TO ORDER: send $3.50 per issue to: Dr. Dobb’s Journal, 
2464 Embarcadero Way, Palo Alto, CA 94303. 


Name 


Address 


City 
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8 character strings. Full string operations including fast matching/extraction. ¢ Flexibly implemented random file access. 


Z (fexpr), lexpr, macro. ® Splicing and non-splicing character macros. * User control over all aspects of the interpreter. 
BA ° Built-in prettyprinting and formatting facilities. © Complete set of error handling and debugging functions including 
7 \ user programmable processing of undefined function references. © Virtual function definitions. ¢ Optional automatic 





| LISP | 


FOR THE 
IBM PERSONAL 
COMPUTER. 


THE PREMIER LANGUAGE 
OF ARTIFICIAL 
INTELLIGENCE FOR 

YOUR IBM PC. 


DATA TYPES 
Lists and Symbols 
Unlimited Precision Integers 
Floating Point Numbers 
Character Strings 
Multidimensional Arrays 
Files 

Machine Language Code 


Mi MEMORY MANAGEMENT 
Full Memory Space Supported 
Dynamic Allocation 
Compacting Garbage Collector 


Mm FUNCTION TYPES 
EXPR/FEXPR/ MACRO 
Machine Language Primitives 
Over 190 Primitive Functions 


10 SUPPORT 
Multiple Display Windows 
Cursor Control 

All Function Keys Supported 
Read and Splice Macros 
Disk Files 


POWERFUL ERROR RECOVERY 
8087 SUPPORT 

COLOR GRAPHICS 

LISP LIBRARY 


Structured Programming Macros 
Editor and Formatter 

Package Support 

Debugging Functions 

.OBJ File Loader 


M@ RUNS UNDER PC-DOS 1.1 or 2.0 
ieee Ru OAD OL Ae Hee ce RI | 





















































IQLISP 
51%/4"’ Diskette 
and Manual. —s——«<SHT1 75.00 
Manual Only ____———s« $- 30.00 








Integral Quality 


P.O. Box 31970 
Seattle, Washington 98103-0070 
(206) 527-2918 


Washington State residents add sales tax. 
VISA and MASTERCARD accepted. 
Shipping included for prepaid orders. 
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if (isdigit(c) ) 
break; 
uy 


} 
LF" 163 

return (atoi(cptrtk) ); 
return (@):3 


} 

/* 

* int numtwo(str, len) 
Se char Str 

eo Int Len; 
* 

* returns the integer value of 
* the second decimal digit string 
* found in string str. 

* Returns zero if there is no 
* second digit string in str. 
a/ 


int numtwo(str,len) 
char *str:; 
int len; 


char cj; *cptr? 
int k,n; 


cptr=str; 
k=; 
while ((c=cptr[k])) 
{ 
if (isdigit(c) ) 
break; 
k++; 


} 
if (c==@) 

return (0); 
cptr=nondigit(cptrtk) ; 
k=cptr-str; 
return (numone(cptr,len-k) ) ; 


/* 
char *nondigit (ptr) 
Crag * ptr: 


advance ptr to the first 
position that is not a digit 
and return the new value of 
the ptr. 


ey, 


char *nondigit (ptr) 
char *ptr; 


+ + + FF 


char c,*cptr; 
cptr=ptr; 
while(1l) 
c=*cptr; 
74 


if (isdigit(c) ==FALSE) 
return (cptr); 
#+Cptr? 


ae 
+ 


lister(here, tohere, topcnt, 
lines, tab, £) 

int here, tohere, topcnt; 

int.lines[{], tab; 

char -*£} 


Print the lines of the file 
from here tohere on the system 
list device using CP/M list 
driver. If here is greater 
than tohere roll around to 

line @ when the end of file 

is reached and continue list. 
The listing should be paginated 
according to the values in 
brouse.h for form width and 
length. Each line should be 
numbered. Expand tabs by tab. 
Print the filename and a page 
number at the top of each page. 


+t FF OF OF OF OF OO OOOO 


+ 
a. 


lister(here, tohere, topcnt, 
lines, tab,f) 

int here, tohere, topcnt; 

int Lines[], tab; 

char *f£;3 

{ 


Char c, *cper; 
int col,row,i,j,page; 


if ((tohere<=0) || 
(tohere>=topcnt) ) 
tohere=topcnt-l; 
if ((here<=@) || 
(here>=topcnt) ) 
here = @; 


i=here; 
page=row=l1; 
col=@; 
while (l) 
{ 
fprint£(2,"\nfilename: $s" 
r£);3 
fpEinte(2;* page %d\n\n" 
,page) ; 


row=rowt3; 
while (row< (FORML-2) ) 
{ 
cptr=lines[i]; 
col=5; 
j=9; 
Eprintl(2; "\rt2d:... "2D: 


(Continued on page 76) 
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Introducing the 


Creative Genius... 








(C_to_dBASE 


ow 
&S Pease qx 


Discover how easy programming can be with DataBurst~” 

YOU A unique runtime screen processor and source program 
e generator, DataBurst™ will decrease your program develop- 

ment time and increase the value of your application programs. The unique 


DataBurst™ screen editor provides fast, easy screen design. Program inde- 
pendent screen formats reduce both development and maintenance time. 


During execution of your program, DataBurst™ controls all user interaction 
through one assembly language interrupt service routine, requiring as little 
as 14K of memory. A true full-screen processor, DataBurst™ allows unlimited 
design complexity, and brings a mainframe advantage to your IBM® PC. 


DataBurst™ is available through your local computer retailer or directly from 
Key Solutions, Inc. To order directly, please send check or money order for - 
$225* to Key Solutions, Inc., P.O. Box 2297, Santa Clara, CA 95055. Additional 
language support (BASIC Compiler and C Compiler) is available for $40° 
(Please inquire about release dates for other language interfaces). 






*In California add 


IBM“ is a registered trademark of IBM Corporation. i 
applicable sales tax. 


DataBurst™ is a trademark of Key Solutions, Inc. 
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¢ Copyright 1984 Key Solutions, Inc. Hf G - 
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The Design Tool for the 


Creative Programmer 
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fa) The MISSING LINK 


C_to_dBASE is a new development tool that 

allows you to manipulate dBASE data and 

index files with programs written in the C 

language. C_to_dBASE provides more than 

70 C language functions including: 

e Functions to access and modify dBASE data 
and index files without using dBASE. 


¢ Powerful C language functions for develop- 

ment of dBASE file management programs. 
e A menu-driven sample application program 

that demonstrates the use of C_to_dBASE. 
¢ Full source code in C. 
¢ No royalties. 
Whether you are a beginning or professional 
programmer, C_to_dBASE is a powerful tool for 
the development of data base applications. 
Only $150.00 (includes source code). 

For More Information Or 
To Order Call: 


800-922-0169 


WM ALS 





CERN t 


SNC 


COMPUTER INNOVATIONS, INC. 


980 Shrewsbury Avenue, 
Tinton Falls, NJ 07724 





Prices are subject to change without notice. 
dBASE is a trademark of Ashton-late. 
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C Function Libraries.”’ 
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COMPLETE 
SOURCES 


& PACK |: Building Blocks | 
250 Functions: DOS, 
Printer, Video, Asynch 


S PACK 2: Database 
100 Functions: B-Trees, 
Variable Records 


a PACK 3: Communications 
135 Functions: Smart- 
modem™, Xon/Xoff, 
Modem-7, X-Modem 


Pa PACK 4: Building Blocks Il 
100 Functions: Dates, 
Text Windows, 

Pull-down Menus 
Data Compression 


a PACK 5: Mathematics | 
35 Functions: Log, Trig, 
Square Root 


PACK 6: Utilities | $99 
Archive, Diff, Replace, Scan, 
Wipe (Executable Files only) 


Lattice™, Microsoft™, DeSmet™, 
Cl-86™ Compilers on IBM PC/XT/AT™ 


Small and Large Menféry Models. 


Credit cards accepted 
($7.00 handling/Mass. add 5%) » 


 e@aaiai 
HORIZONS 
inc. 


solo =1>101(0] 40 Me) ics1 11 
Burlington, Mass. 01803 
(617) 273-4711 


NOVUM ORGANUM 
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F, ile Br owser Lis ting (Listing Continued, text begins on page 60) 


while ((c=cptr[j++])) * commands with syntax and 
* results shown. If new commands 
if (c=='"\t') * are added make sure you add 
* them here also. 
{ * / 
do 
{ help() 
pute (*.',2): { 


col++t: 
} while ((col%tab) && 
(col< (FORMW-1) )); 


} 
else if ((col>=(FORMW-1) ) 
&& (c l= "\n')) 


pute (un 2) 3 
break ; 


else 


{ 
putc(c,2)3 
colt+t: 


} 
} 
rowt+; 


col=5; 
if (i==tohere) 


col=@; 
break; 


} 
if (++i >= topcnt) 
i=@; 


} 
while (rowt++ <= FORML) 
potc( "n't, 2) 


pagett; 
row=l1; 
putc('\r',2); 
if (col==@) 
break; 
f* } 
* This comments out the pause at 
* the end of each page, reinstate /* 
* these two lines of code for 
* single sheet paper feeding. 
* 
/* 
printf("\rpage %3d:",page) ; 
printf(" any key to continue > "); 
c=getchar(); 
ee 
} 
} 
/* 
* int help() 
* 
* Command help facility. Display 
* a concise list of the browse 
76 


printf (CLEARS) ; 

printf("\n Browse Command") ; 
printf(" Information\n") ; 
printf ("\nCommand Results") ; 


PEER E (Tree oe ee ry 
printf("\n # redisplay"); 
printf£(" with line # in center"); 
printf("\n # u go up #"); 
printf(" lines and redisplay") ; 
printf("\n #d go down #"); 
printf(" lines and redisplay") ; 
printf (*\n b redisplay"); 
printf(" beginning of file"); 
printf("\n e redisplay"); 
printf(" end of file or buffer"); 
printfl("\nost reset tab"); 
printf(" stops to every # spaces") ; 
printf("\n and redis"); 
printf("play screen. Tab stops"); 
printf("\n default to"); 
printf(" every 4 spaces”) ; 
print£("\n #n go down #"); 
printf£(" pages ( default is one )"); 
printf("“\n # p go up # p"); 
printf("ages ( default is one )"); 
printf("\n q quit and ™)? 


printf("return to operating system") ; 
printf£("\n # # 1 list file "); 
print£("from first # to second # on"); 
printf("\n the system "); 
printf("list device ( printer )"); 
printf("\n # represents any "); 
printf("positive integer"); 
printf£("\nenter any command or") ; 
printf£(" a return to redisplay\n"); 


end of the special functions */ 


End Listing 
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APROTEK 1000™ EPROM PROGRAMMER 




































TECHNICAL 
BREAKTHROUGH 
NOW ALLOWS A 





PRICE 
BREAKTHROUGH 





only 
$250.00 


A SIMPLE, INEXPENSIVE SOLUTION TO PROGRAMMING EPROMS 


The APROTEK 1000 can program 5 volt, 25XX series through 2564, 27XX 
series through 27256 and 68XX devices plus any CMOS versions of the above 
types. Included with each programmer is a personality module of your choice (others 
are only $10.00 ea. when purchased with APROTEK 1000). Later, you may re- 
quire future modules at only $15.00 ea., postage paid. Available personality 
modules: PM2716, PM2732, PM2732A, PM2764, PM2764A, PM27128, 
PM27256, PM2532, PM2564, PM68764 (includes 68766). (Please specify 
modules by these numbers). 

APROTEK 1000 comes complete with a menu driven BASIC driver programmer 
listing which allows READ, WRITE, COPY, and VERIFY with Checksum. Easily 
adapted for use with IBM, Apple, Kaypro, and other microcomputers with a RS-232 
port. Also included is a menu driven CPM assembly language driver listing with Z-80 
(DART) and 8080 (8251) I/O port examples. Interface is a simple 3-wire RS-232C 





with a female DB-25 connector. A handshake character is sent by the programmer 
after programming each byte. The interface is switch selectable at the following 
6 baud rates: 300, 1.2k, 2.4k, 4.8k, 9.6k and 19.2k baud. Data format for program- 
ming is ‘‘absolute code’’. (i.e., it will program exactly what it is sent starting at 
EPROM address 0). Other standard downloading formats are easily converted to 
absolute (object) code. 


The APROTEK 1000 is truly universal. It comes standard at 117 VAC 50/60 HZ 
and may be internally jumpered for 220-240 VAC 50/60 AZ. FCC verification 
(CLASS B) has been obtained for the APROTEK 1000. 

APROTEK 1000 is covered by a 1 year parts and labor warranty. 


FINALLY — A Simple, Inexpensive Solution To Erasing EPROMS 


APROTEK-200™ EPROM ERASER APROTEK-300™ only $60.00. 

t EPROMS This_ eraser is identical to APROTEK- 
a aE eo sen $6 minutes, 200™ but has a built-in timer so that the 
you switch OFF and are ready to ultraviolet lamp automatically turns off in 
reprogram. 10 minutes, eliminating any risk of overex- 


APROTEK-200™ only $45.00. posure damage to your EPROMS. 
aed APROTEK-300™ only $60.00. 


APROPOS TECHNOLOGY 
1071-A Avenida Acaso, Camarillo, CA 93010 
CALL OUR TOLL FREE ORDER LINES TODAY: 
1-(800) 962-5800 USA or 1-(800) 962-3800 CALIFORNIA 
TECHNICAL INFORMATION: 1-(805) 482-3604 
Add Shipping Per Item: $3.00 Cont. U.S. $6.00 CAN, Mexico, HI, AK, UPS Blue 
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FORTH 


including 


SOURCE CODE 


Developing your own system? Or, just Curious 
about how things work? Either way, SOURCE CODE 
is Q must! 

KFORTH was developed for use in microproces- 
sor based controllers used by the U.S. Government. 
It includes CASE statements, a built-in assembler, 
and CPM file handling. Best of all, you can change it 
to fit your needs. 

SUPER KFORTH was developed for increased 
speed. It uses DIRECT THREADED CODE and is up to 
10x faster. Both are written in assembler and can be 
assembled using ASM.COM. Both generate reen- 
trant and ROMABLE code. 

(For use with Z80, 8080, 8085 CPM systems) 


FILL OUT COUPON TODAY AND MAIL TO: DJ 
KIMRICH COMPUTER DESIGNS, INC. 
10404 Patterson Avenue, Richmond, VA 23233 (804) 741-5930 
1) YES! | want SOURCE CODE! Enclosed is my check for: 


C1) SUPER KFORTH 
(In VA add $1.60 sales tax (4%)) (In VAadd $3.20 sales tax (4%)) 


My disk format is: (Call for availability of other formats) 
0 8 inch SSSD OU Osborne SD 0 Kaypro 
0) 5-4/4 inch SSSD 1) Osborne DD 

For VISA or MasterCard orders phone (804)741-5930. 


Name 
Address 


City 
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MicroMotion 





MasterFORTH 


It's here — the next generation 
of MicroMotion Forth. 


Meets all provisions, extensions and experimental 
proposals of the FORTH-83 International Standard. 


Uses the host operating system file structure (APPLE 
DOS 3.3 & CP/M 2.x). 


Built-in micro-assembler with numeric local labels. 


e Afull screen editor is provided which includes 16 x 
64 format, can push & pop more than one line, 
user definable controls, upper/lower case key- 
board entry, ACOPY utility moves screens within & 
between lines, line stack, redefinable control 
keys, and search & replace commands. 


Includes alll file primitives described in Kernigan 
and Plauger’s Software Tools. 


@ Theinout and output streams are fully redirectable. 


e Theeditor, assembler and screen copy ufilities are 
provided as relocatable object modules. They 
are brought into the dictionary on demand and 
may be released with a single command. 


Many key nucleus commands are vectored. Error 
handling, number parsing, keyboard translation 


and so on can be redefined as needed by user 
programs. They are automatically returned to 
their previous definitions when the program is 
forgotten. 


The string-handling package is the finest and 
most complete available. 


A listing of the nucleus is provided as part of the 
documentation. 


The language implementation exactly matches 
the one described in MASTERING FORTH, by Ander- 
son & Tracy. This 200 page tutorial and reference 
manual is included with MasterFORTH. 

Floating Point & HIRES options available. 


e Available for APPLE II/Il+/lle & CP/M 2.x users. 
MasterFORTH — $100.00. FP & HIRES -S40.00 each 


Publications 
e@ MASTERING FORTH - $20.00 


e@ 83 International Standard — $15.00 


@ FORTH-83 Source Listing 6502,Z-80,8086 - 
$20.00 each. 






Contact: 


MicroMotion 
12077 Wilshire Bivd., Ste. 506 

Los Angeles, CA 90025 
(213) 821-4340 
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An Introduction to Parsing 





by Dr. Henry A. Seymour 
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hat is parsing and why 
VV would a programmer want 
or need to learn about it? 


Well, parsing is the process of break- 
ing down an input string into its most 
elementary parts, referred to as tokens. 
The portion of a program that per- 
forms this action is called the parser. 
Parsers are used in many areas of 
computing: 

(1) A compiler translates a high-level 
language such as Basic or Fortran into 
object code. Usually one Fortran state- 
ment translates into about six object 
code instructions. 

(2) An assembler translates an assem- 
bly language program into object code 
instructions. The assembly language is 
machine dependent; usually each in- 
struction is translated into one ma- 
chine instruction. 


gram with indentations at the appro- 
priate places. 

(6) A command language processor is 
a program that accepts the job control 
language of the operating system and 
determines the meaning of the request. 
(7) A query language processor is a 
program that accepts English language 
requests, determines their meaning, 
and performs the inquiry from a data 
base. 

(8) A text editor is a program that ac- 
cepts a string of commands and, based 
upon those commands, creates or mod- 
ifies a file. 

All of these applications are interest- 
ing enough to discuss in detail; however, 
because most readers are probably fa- 
miliar with an assembly language, I will 
use the assembler as the vehicle of dem- 
onstration. Knowledge obtained in the 


What smart databases, adventure games, Basic inter- 
preters and Latin teachers have in common. 


(3) An interpreter is an operation simi- 
lar to the assembler, but the computer 
executes the machine instruction imme- 
diately; the compiler and assembler 
produce object code for later 
manipulation. 

(4) A translator is a program that 
takes as input a source language and 
produces an equivalent version in the 
same language or in a different lan- 
guage; for example, Fortran 66 to For- 
tran 77, RPG to COBOL, etc. 

(5) A pretty printer is a program that 
takes as input a source program, such 
as Pascal, and outputs the same pro- 


Dr. Henry A. Seymour, Martin Mari- 
etta Aerospace, P.O. Box 6184, 
Huntsville, AL 35806. 


designing and writing of a parser for an 
assembler should be easily applied to 
any of the other areas. 


Assembler 

In the parsing process, an input string 
first must be scanned to obtain the to- 
kens of data, then the tokens must be 
evaluated to determine whether they 
are meaningful. For example, the in- 
put string 


LOOP LOAD VALS 


must be scanned, and the tokens must 
be isolated: 


[Loop] [roan] [vac] L] [5] 
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Then a decision can be made as to 
whether the string of tokens represents 
a valid instruction. 

The first step in writing an assem- 
bler is to state the characteristics of the 
assembly language. The language that 
I will describe does not represent an 
existing language but is for demonstra- 
tion purposes only. It is, however, simi- 
lar to many assembly languages avail- 
able today. The format is: 


[label] operation operand [,register] 


The brackets indicate that the enclosed 

field is optional. Characteristics of the 

language are: 

e Blanks and commas are delimiters. 

¢ The label must begin in column one. 

¢ Each field is either numeric or 
alphabetic. 

The second step is to analyze the lan- 
guage’s characteristics to determine its 
logical structure. A graphic display of 
this logical structure is called a transi- 
tion diagram. Figure 1 (below) shows 
the logical structure of the language de- 
scribed above. The characteristics of a 
transition diagram are: 

e Circles are called states. 

¢ Arrows indicate transition paths. 

¢ Double circles mean a terminating 
state. 

The characters associated with the 
arrows Cause control to move from one 
state to another. The characters within 
the circles represent the state type: 
¢ DS is the delimiter state (the begin- 

ning state). 

e SS is the symbol state. 

e NS is the number state. 

¢ TS is the terminal state (ending 
state). 

Let’s go through both paths of the 
transition diagram to see if it will ac- 
cept the language defined above. We 
begin at the delimiter state, DS. If the 
first character is alphabetic, control 
proceeds to the symbol state, SS, 
which contains the intelligence of the 
program. Control at SS implies that an 
alphabetic field is being parsed. 

The looping arrow returning to SS 
means that control will accept any 
number of alphabetic characters and 
will remain in SS. However, upon en- 
countering either a blank or a comma, 
control will proceed to the terminal 
state, TS. This means that the process 
has arrived at a point where a token 
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has been obtained and can be saved in 
some location. To allow the next token 
to be retrieved, control is given back to 
the delimiter state, DS. 

Now consider an alternate path: Ifa 
digit is encountered, control will pro- 
ceed to NS. Being at NS implies that a 
digit has been found, and control will 
remain at NS as long as digits are en- 
countered. Upon recognizing a blank 
or a comma, control will proceed to the 
terminal state. 

The transition diagram will recog- 
nize only one unit of information at a 
time: a number, a symbol, or a delimit- 
er (either the blank or the comma). 
This is a simplistic model that doesn’t 
consider error conditions. I will discuss 
that topic later on. 

The Pascal-like program in Listing 
One (page 82) represents the logic in 
the transition diagram. The functions 
BLANK, COMMA, ALPHA, and NUM- 
BER test the character to determine its 
class. The assumption of the program 
is that the input record is read into an 
array. The procedure GET_CHAR will 
move a character from the input array 
into CHAR for later testing by BLANK, 
COMMA, ALPHA, and NUMBER. After 


the character has been tested it will be 
moved into the token array by the pro- 
cedure MOVE_CHAR. 

The point to recognize here is that 
the transition diagram has helped a 
great deal in describing the program 
logic. To check for more complex 
structures in the assembly language 
and for error conditions, the program 
must become very large and hence 
more difficult to read. In that case, the 
transition diagram will be an even 
more important aid in the program de- 
sign process. 

Although this approach to the im- 
plementation of a parser is preferable 
to having no developed plan at aH, a 
better and simpler approach gives 
greater control over the parsing pro- 
cess. That approach involves one addi- 
tional step: the creation of a state 
diagram. 


State Diagram 

The state diagram is equivalent to the 
transition diagram, but it can be im- 
plemented with greater ease and with 
less source code. The state diagram is a 
two-dimensional representation of the 
transition diagram. Each state—that 


Transition Diagram: 





Input Character 


Figure 2. 


State Diagram 
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is, each circle—in the transition dia- 
gram is represented as a row in the 
state diagram. The terminal states— 
that is, double circles—are the excep- 
tion and are represented as rows. The 
transition diagram in Figure | would 
be represented by the state diagram in 
Figure 2 (page 79). 

The contents of the array are the 
states that may be reached. The termi- 
nal state does not need a row because, 
once it is recognized, there is no reason 
to continue using the array. In the pro- 
cess of transforming the transition dia- 
gram into the state diagram, two error 
conditions became obvious. When in 
SS, no exit path exists for a digit, and 
when in NS, no exit path exists for a 
symbol. Temporarily, I will place the 
state code TS in the appropriate cells; 
later I will discuss how to specify error 
states. 

As shown in Figure 3 (below), the 
input record is held in an array called 
an input buffer, and the parsed token is 
placed into a token buffer. The source 
record is read into the input buffer, 
and a pointer is used to point to each 
position. The program scans the input 
buffer, copying characters into the to- 
ken buffer. Upon encountering a de- 


Input Buffer 


‘(loop 15 “TOTALS 


limiter, the scanning process stops: the 
token buffer contains a unit of 
information. 

After the token has been parsed, 
control is returned to the parsing pro- 
cess with the input pointer pointing to 
the character that caused the tempo- 
rary halt. The process begins again at 
the delimiter state, and another token 
is parsed. The process continues until 
an end-of-line condition is detected. 

The program in Listing Two (page 
82) represents the state diagram 
shown in Figure 2. The function TYPE 
in Listing Two determines the catego- 
ry of the input character, as shown in 
Figure 2, and expresses that in the 
form of a column value. The program 
uses two variables, OLD_STATE and 
NEXT_STATE, to hold the state code 
of the token that is presently being 
constructed and the next state that the 
program is about to enter. The if state- 
ment determines how a token has been 
recognized. The implementation of the 
state diagram is efficient, easy to un- 
derstand, and maintainable. 


Error Conditions 
The trapping of some errors can be im- 
plemented in the state diagram; how- 


eure 


_ (2 inputPointer 


Token Buffer 





___ Token Pointer 


_ Figure 3. 
_ Data Structures 





_ Input Character 


State Diagram with Error Traps 
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ever, certain errors should be checked 
only after the token has been obtained. 
For example, if the language specifica- 
tions state that a label and operand 
variable be six characters or less, then 
the program must check for this. In the 
process of making a general but effi- 
cient model, however, some capabili- 
ties such as counting are unavailable. 
The solution is to scan the input 
buffer, moving characters into the to- 
ken buffer, until a delimiter is encoun- 
tered. After the token has been ob- 
tained, its length can be determined. If 
the length is in error, an appropriate 
error message can be displayed. A typ- 
ical error check for length would be: 


FOUND: if OLD_STATE = SS and 
LENGTH(TOKEN) >6 then 
ERROR( ‘LENGTH ERROR’); 


Another type of error is the combin- 
ing of two tokens. In the present speci- 
fications, it is invalid to mix letters and 
numbers, such as LOADS. The present 
state diagram will go to TS upon en- 
countering the 5, but, upon reaching 
the FOUND label, the error will not be 
obvious. A token of 5 will be found 
next, and it will be up to another por- 
tion of the program to determine 
whether an error has been found. This 
kind of error causes the program to as- 
sume that the entire field has been ob- 
tained, which invalidates the remain- 
ing parsing operation. It can also cause 
multiple error statements to be printed 
when, in fact, only one error exists. 

The state diagram could be rewritten 
to give it more error checking capabili- 
ty. This would be important if the pro- 
grammer wanted to make the processor 
user friendly. How user friendly a pro- 
gram is depends on its ability to recog- 
nize errors, identify them to the user, 
and if possible make corrections. How- 
ever, the more user friendly the pro- 
gram, the larger and more complex it is. 

The state diagram in Figure 4 (at 
left) includes two new states, El and 
E2. The state diagram now has the abil- 
ity to trap the two error conditions, such 
as Al and 1A. There are no rows for 
these new states, and they will be treat- 
ed similarly to the state TS; that 1s, 
when the program encounters El or E2, 
it will discontinue the use of the state 
diagram and proceed to a portion of the 
program that handles the error 
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Dr. Dobb's Journal 


A. Your primary job function: (Check one only) 


LJ Company management (Pres., V.P, Treas., 
Owner, Gen. Mgr., Mktg. Dir.) 

L] Computer systems management (V.P. EDP, 
MIS Director, Data Processing Mgr., Data 
Communications Mgr., Network Planner) 

LJ Engineering management (V.P. Engrg., Chief 
Engr., Tech. Director, Dir. R&D) 

L} Systems integrators (Systems Designer, Project 
Engr., Systems Application Engr., Technical 
Staff Members) 

LJ Consultants (Computer/EDP/Data Communi- 
cations Consultant) 

L] Educators (Educational users and instructors 
of computer technology) 

LJ Systems/Programming specialists—mini-micro 
systems 

CL] Other (Please specify) 


B. Which languages are you MOST interested 
in? 


CJ] BASIC LIC LJ PL/I 

CJ Fortran LJ LISP LJ APL 

LI] COBOL J Prolog [} Logo 

LJ Pascal LJ Ada LJ Smalltalk 
CJ Modula-2. 0 Forth Other 


C. What is the operating system? 


L] CP/M (or derived) 

L) UNIX (or derived) 

L] MS-DOS (or derived) 
CL) Other 
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D. Please indicate which of the following micro- 
computers you currently own and/or plan to 
buy in the next 12 months. 


E. What best describes the work you do with 
this microcomputer? 


_}] Business functions 


Plan CF Software/Hardware development 
ae Pe Buy CO ScientifidEngineering/R&D applications 

Cees 0 O F. Are you the decision maker or very influential 
Digital Equipment/DEC O O in computer-related purchases at work? 
Heathi/Zenith O CJ Co Yes No 

P O 
‘ba aie = oO G. Is your company a dealer, distributor, or 
Macintosh O O systems house for microcomputers? 
Radio Shack/Tandy TRS 80 O O CO Yes L} No 
Texas Instruments LO LO 
None O O LO Yes L} No 


To obtain information about products or services mentioned in this issue, circle the appropriate number listed below. 
Use bottom row to vote for best article in issue. One card per person. 


1 23 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 24 25 26 27 
28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 8I 


82 
109 


83 84 85 86 87 88 89 90 91 92 93 94 
110 111 112 113 114 115 116 117 118 119 120 121 


95 96 97 98 99 100 101 102 103 104 105 106 107 108 
122 123 124 125 126 127 128 129 130 131 132 133 134 135 


Articles: 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 
nnn Atl Sth IS AIF 


Name 
Address 
City/State/Zip 
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conditions. 

The code associated with the 
FOUND label now can check to deter- 
mine whether either of these errors has 
occurred and, if so, what information 
may be transmitted to the user. The 
code in Listing Three (page 86) shows 
one approach to this. 


Expanded Assembly Language 
Let’s increase the strength of the pseu- 
do-assembly language and create a 
state diagram that will recognize all 
possible valid tokens. The new instruc- 
tion format is: 


[label] operation operand {, register] 


Procedure GET_TOKEN;, 


The characteristics of the language 

follow: 

¢ Blanks and commas are delimiters. 

e The operand and register may be a 
symbol, an integer value, or a hexa- 
decimal value. 

¢ The X followed by a string indicates 
a hexadecimal value (X‘1F’). 

¢ The operation field must be a 
symbol. 

¢ The label must begin in column one. 

e The instruction is free form but must 
be stated completely on one record. 

e The operand field may contain one 
or two operands separated by one of 
the following arithmetic operators: 

ae ene f- 


DS - GET_CHAR ( fom input buffer to CHAR 2+). 


if BLANK(CHAR) then go to DS 


else if ALPHA(CHAR) then go to 35 
else if NUMBER(CHAR) then go to NS 
else if CONE) then 1a to TS; 


. MOVE_CHAR ¢ en CHAR to 1oKen buffer *); 
GET_CHAR (* from input buffer to CHAR *); — 


if ALPHA(CHAR) then go to SS 





— _ebsei BLANKICHAR) or COMMA(CHAR) then ngo to oTS; | 


2 MOVE_CHAR aot Cuno were : 





from input buffer to CHAR *); 


ok 'NUMBER(CHAR) then to to NS | 
else if BLANKICHAR}or COMMAICHAR) then go to TS; 


: Ce do work with recognized token ) 


_ Listing one 





t fon cee buffer to CHAR"), . = 
ve TYPE(CHAR); _ 
— AE ARRAY(OLD_STATE, COLUMN); 
it NEX _STATE. # DS then - 
_ a TERMINAL(NEXT_STATE)_ then go to FOUND 





else 
“begin 


end 


MOVE_CHAR (* from CHAR se toner Banner 
OLD_STATE 


: = NEXT_STATE; 


else null (* skip blanks *); 
until INPUT_POINTER >BUFFER_LIMIT; 
(* Token has been found. 
_ Type of token is described by the contents 


of old_state. *) 





e The operand may contain a literal, 
such as RSTU. 

By analyzing these characteristics, 
one can begin to design the transition 
diagram. The first noticeable charac- 
teristic is that variables are made of let- 
ters and numbers. Also, numeric, hexa- 
decimal, and character fields all use the 
common alphabetic and numeric set of 
characters. This will be an important 
feature in the transition diagram. 

A study of these features determines 
the states that must be defined, the 
paths between the states, and possible 
error conditions. The transition dia- 
gram in Figure 5 (page 83) represents 
a program that can recognize tokens as 
well as some error and warning condi- 
tions. The error and warning features 
include a suffix digit, which uniquely 
identifies the condition that has been 
detected. Also included is the ability to 
recognize the end of the input line. The 
meaning of each state code in Figure 5 
is as follows: 
¢ BS is the blank state (beginning 

state). 

e DS is the delimiter state. 

¢ XS is the X state (might be a symbol 
or hexadecimal state later). 

e HS is the hexadecimal state. 

e SS is the symbol state. 

e NS is the numeric state. 

e QS is the quote state. 

e OS is the operator state. 

In designing the transition diagram, 
I specified that a hexadecimal string 
have only the letters A through F and 
the numbers 0 through 9. Because the 
transition diagram cannot determine 
the running value of a hexadecimal 
number or a decimal number that is 
being parsed, this type of error trap 
must be expressed as source code. It is 
possible to trap the error condition 
when a hexadecimal string contains an 
invalid character, such as the letters G 
through Z. This same error can be 
trapped at a later point in the program. 
The programmer may choose where to 
place the trap. The error states, warn- 
ing states, and terminal states do not 
have an equivalent row representation 
as do the other states. These states 
must be trapped by the program and 
appropriate action taken. 


Expanded State Diagram 
The columns in the expanded state dia- 
gram (Figure 6, page 84) are almost as 
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straightforward as before. One must 
have a column for each unique type of 
data that is expected, plus a generic 
“else” column for unexpected or erro- 
neous data. In many cases, each 
unique edge in the transition diagram 
in Figure 5 corresponds to a column in 
the state diagram in Figure 6. 
However, as mentioned earlier, the 
definition of variables, hexadecimal 
strings, character strings, and numbers 
uses the same character set. The X 
must have a column to note the possi- 
ble beginning of a hexadecimal string. 
Because X might also be the beginning 
of a variable, it will be necessary to de- 


termine whether the program has ar- 
rived at a terminal state and OLD- 
_STATE is XS. This means that the X 
was recognized, the transition to state 
X was taken, and a symbol other than 
a quote caused the transition to the ter- 
minal state. In fact, the X is a symbol, 
and OLD_STATE must be changed to 
SS. A variable can include any of the 
alphabet and the digits, but because 
the digits must be separately recog- 
nized they must have their own col- 
umn. The characters that make the 
hexadecimal string are a subset of the 
alphabet plus all the digits. As a result, 
there is no column just for variables or 


_ Input Character 


= cw 


b uh viz 0-9 


+|- 


: ; “|/ eol else 


| [SS SS [RS [OST OS os [rs [ae 
XS 
HS ez fez tose fos rs Tea Tea [wiles 
SS ‘SS [ss fer fre preps fer 
NS 
as 
Os 


: Figure 6 
Expanded State Diagram 


- Figure 7 
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OLD_STATE 
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Figure 8 
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hexadecimal strings. 

The process of combining the opera- 
tors into one column requires that the 
program determine, at a later point, 
which operator it has found. It would 
be possible to have a column for each 
of the operators, but the cost of extra 
memory to represent them is probably 
not worth it. 

The operand field is restricted to a 
simple set of cases, such as: 


A 
A+B 
A+B 
A*B 
A/B 


For the assembler to handle more com- 
plex arithmetic, we would have to 
delve into operator precedence pars- 
ing. An expression parser would build 
on this work, taking identified tokens 
as its input. 


Error and Warning Messages 

It is possible to have all error traps dis- 

play one generic statement, i.e., IN- 

VALID STATEMENT. Also the pro- 

gram might make no attempt to 

correct statements, even though it 

could do so, but this would not be char- 

acteristic of a user-friendly program. 

The error and warning messages that 

are referred to in Figure 6 are listed as 

follows: 

¢ El —invalid symbol 

e E2 -invalid hexadecimal character 

e E3—-invalid numeric character 

e E4- invalid arithmetic syntax 

e E5 — unrecognizable character 

¢ E6 — missing register 

e W1 — missing closing quote in hexa- 
decimal (quote provided) 

e W2 - missing closing quote in string 
field (quote provided) 

When a warning state has been 
reached, the program should repair the 
string and set the variable OLD 
_STATE to the appropriate value. For 
example, if WI is recognized and the 
closing quote is provided, then the 
OLD_STATE should be set to HS. 


Master Driver 

In the discussion thus far, the main 
point has been to obtain one token at a 
time. During the process, error check- 
ing determined whether a valid token 
had been obtained. However, it is pos- 
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sible to collect a string of valid tokens 
without constructing a valid instruc- 
tion. For example, 


is a string of valid tokens, but it is not a 
valid instruction according to the lan- 
guage specifications. 

We can define a transition diagram 
for valid tokens then convert that to a 
state diagram. The implementation of 
the token state diagram to retrieve a to- 
ken will then perform as a servant to the 
master state diagram, which deter- 


(r ther work here: *) 
tN NEW_STATE - = €1 then 
begin | / 


FOUND : 


mines the validity of the input instruc- 
tion. Figure 7 (page 84) shows a transi- 
tion diagram for a program that 
determines whether instructions are 
correct. This master transition diagram 
makes use of information obtained by 
the token transition diagram. The tran- 
sitions from one state to another use the 
states of the token transition diagram 
rather than characters. This is a more 
general view of the input command. 
The meaning of each new state sym- 
bol in Figure 7 is as follows: 
¢ ST is the start state. 
e OP is the operation state. 
¢ O1 is the first operand (terminal 


” ERROR( INVALID SYMBOL); 


fw other work here *) 
end — 


‘else if NEW. STATE - = E2 then 


- begin 


= end | 







Procedure MASTER_STRING: 


_ else ERROR; - 
OP : _ GET_TOKEN; 






7 . else ERROR; 
Ol. : ] GET_TOKEN; 








eee BRO 
AO: ©) GETATOKEN, 







else ERROR: 
02: — GET_=TOKEN; 








_ else ERROR; 
Db GET_TOKEN; 







: else ERROR; 
- AG: GET_TOKEN; 







else ERROR; 
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it column . on is-not ak then GET_LABEL; : 


if OLD_STATE = - §S then go to OP 


Listing Four 


_ ERROR(’ INVALID NUMBER’ ): 
7 other work here ) 





| 2 Listing Three 


it OLD_STATE is is in 0 HS NS, $5, OS) then ¢ go to 01 


_ ‘ftinput “character - = = eol then (* found acceptable string *) 
if OLD_STATE = Os then go to AO; _ 
if OLD_STATE = DS then go to DL 


if OLD_STATE is in (HS, NS, SS, OS) then got to 02 


if input_character = eol then (* found ho eoienk string *) 
if OLD_STATE = DS then go to DL 


if OLD_STATE is in (HS, NS, SS) then go to RG 


if input_character = eol then (* found acceptable string .) 


state). 
e AO is the operator state. 
¢ ©2 is the second operand (terminal 
state). 
e DL is the delimiter state. 
¢ RG is the register state (terminal 
state). 
In Figure 7, at only three states would 
it be acceptable to terminate: Ol, O2, 
and RG. To stop while at any other 
state would indicate an incomplete 
command. 

The state diagram shown in Figure 8 
(page 84) reflects the logic of the tran- 
sition diagram in Figure 7. I have left 
all the error entries blank, assuming 
that the reader would like to apply the 
knowledge gained so far by specifying 
the error codes. The partial program 
shown in Listing Four (below) is a rep- 
resentation of the state diagram in Fig- 
ure 8. 

The program begins by checking for 
the presence or absence of the label. If 
a label is present, it must be entered in 
a symbol table: hence the need for the 
special procedure, GET_LABEL. This 
instruction is not represented in the 
transition diagram but is implied by 
the specifications of the language. The 
program determines at three points 
whether a valid command has been 
found. These terminating points are in- 
dicated by the double circles in Figure 
7 and by the “if input_character = 
eol’’ statements in Listing Four. 


Summary 

The discussion about the general area 

of parsing has outlined an efficient 

method of implementing the parsing 

process: 

¢ Analyze the characteristics of the in- 
put data. 

¢ Produce a transition diagram. 

e Produce a state diagram. 

e Write the source code. 

A method of trapping error conditions 

has been shown, and a coding tech- 

nique that indicates uniquely which er- 

ror occurred has been demonstrated. 

Also discussed was a method of cor- 

recting an error condition and giving 

an appropriate warning message. This 

information should be applicable to 

most areas of computing. DD} 
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by Ray Duncan 
Readers Pitch M68000 


The 16-Bit Mailbag brought me no 
less than 10 letters and cards this 
month from readers requesting more 
material on the Motorola 68000. Inter- 
estingly, not a single one of these read- 
ers contributed a 68000 programming 
tip, listing, or any other words of wis- 
dom. Come on, guys, we aren’t operat- 
ing in a vacuum here! 

Those readers who hoped that the in- 
troduction of the Macintosh would lead 
to the development of scads of 68000 
public domain software are going to be 
sadly disappointed. In the first place, 
Apple has outsmarted itself by making 
program development on the Macin- 
tosh hideously difficult. The native 
high-level languages available for the 
Mac are (by IBM PC or even by Z80 
CP/M standards) incredibly weak, bug- 
ridden, slow, and nonstandard. For ex- 
ample, MacBASIC can’t even run the 
BYTE Sieve of Eratosthenes bench- 
mark because the Mac runs out of 
memory. As its latest practical joke (or 
maybe this is just a nose-thumbing ges- 
ture at the free-lance software develop- 
er), Apple has released an assembler for 
the Mac that won’t run on just one 
Mac—you need two. It seems a little 
incredible, no matter how badly the 
Mac’s 68000 is crippled with overblown 
operating system software, that the 
self-proclaimed wizards at Apple 
couldn’t get a two-pass assembler to 
run on a third-generation microproces- 
sor equipped with 128K of RAM and a 
300K-+ disk drive. The old Digital Re- 
search 8080 assembler ran nicely in 
32K with room left over for the operat- 
ing system. 

Let’s travel back in time to the Feb- 
ruary 1984 BYTE magazine, in which 
Steve Jobs was quoted as saying (page 
63): ‘““This is an IBM video board; it’s 
only video, nothing else. It’s 69 inte- 
grated circuits, more chips than an en- 
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tire Macintosh, and it basically does 
nothing. And it doesn’t even do that 
very well.” Talk about hubris! Re- 
member, that quote was from the same 
guy who brought you an assembler 
that requires two computers. 

It’s becoming clear that the Macin- 
tosh’s fate will be similar to the fate of 
the Lisa—critical acclaim, but lack- 
luster sales. My inside source in Cu- 
pertino, Deep Golden Delicious, tells 
me that in the year since the Mac’s an- 
nouncement, approximately 200,000 
machines have been delivered. Think 
back to all that hoopla we were bom- 
barded with last winter, about a super 
Macfactory for Macs that can grind 
out one Mac every 15 seconds. Consid- 
er that in the same time period, more 
than a million each IBM PCs and Ap- 
ple IIs went out the door. Now, I sup- 
pose I’m going to get piles of nasty let- 
ters from the MacWorshipper crowd. 
At least then we'll have 68000 topics 
galore to write about, won't we? 


Some 8086 Debugging 


Hidden in the obscurities of the Intel 
8086 instruction set are some classic 
booby traps that can take hours (yes, 
even days) to debug. Here are two to 
watch out for. 

Consider the assembly code in List- 
ing One (page 93). This is the source 
for a Forth ROLL command, which 
picks a word out of the interior of the 
machine stack and moves it to the top 
of the stack. Clue No. 1: As written 
here, the command executes correct- 
ly—most of the time. Clue No. 2: In 
the Intel iAPX 86,88 User's Manual 
(page 2-42), the fine print says that 
“execution does not resume properly 
[after an interrupt] if a second or third 
prefix ... has been specified in addi- 
tion to any of the repeat prefixes.” 
Aha! This code fails because, at unpre- 
dictable intervals, a hardware inter- 


rupt occurs during the repeated execu- 
tion of the string instruction. The 8086 
loses track of either the addressing 
context or the repeat prefix itself upon 
return from the interrupt (depending 
on the order in which prefixes were as- 
sembled): consequently, either the 
wrong number of words is moved, or 
the words are moved from the wrong 
source address. 

Now look at Listing Two (page 93). 
This code is supposed to transfer a num- 
ber from the top of the 8086’s machine 
stack to the top of the 8087’s machine 
stack. It works correctly “most of the 
time.” The bug here results from a sub- 
tle failure of synchronization. Since the 
programmer failed to include a WAIT 
after the FLD[ BX] instruction before in- 
crementing the 8086's stack pointer, a 
hardware interrupt could occur and be 
serviced after the ADD SP.8 instruction 
is executed but before the 8087 has com- 
pleted its transfer of the number from 
shared memory. Thus, the process of 
servicing the interrupt will push the CPU 
flags and return address on top of the 
number that the 8087 is loading, partial- 
ly or completely destroying that number. 
This type of problem is extremely tough 
to isolate. Users can best avoid the prob- 
lem altogether by paying scrupulous at- 
tention to synchronization and stack 
protection. 


Sneak 80286 Preview 


Since IBM has put its Good Comput- 
ing Seal of Approval on the Intel 
80286 with the introduction of the PC/ 
AT, it behooves us all to start learning 
to use this processor properly. The 
80286, when running in “Protected 
Virtual Address”? mode, is a fearsome 
beast. It has several new addressing 
considerations, hardware-recognized 
data structures and descriptors, and 
memory protection mechanisms; it is 
to an 8086 what a VAX is to an LSI-11. 
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However, the 80286 in ‘‘Real Ad- 
dress” mode can be viewed as a slightly 
tuned up 8086; this is helpful to us ag- 
ing, simple-minded software develop- 
ers. Fortunately or unfortunately, PC- 


DOS and MSDOS 3.0 use the 80286 in 


Real Address mode, so we can safely 
ignore the more complex consider- 
ations for the present. 


Changed Instructions 

To start with, let’s look at some subtle 
differences between the instruction 
sets of the 8086 and the 80286. 

¢ The instruction PUSH SP pushes the 
current pointer, rather than the new 
stack pointer. In other words, the 8086 
did something like this: 


PUSH SP = 
Sr = SP 
(SP) := SP 
while the 80286 does something like 
PUSH SP = 
TEMP >= SP 
SP Sere 2 
(SP) == TEMP 
So the 80826 instruction 
PUSH SP 
has the effect of the 8086 sequence 
MOV AX,SP 
PUSH AX 


¢ The 80286 divide error exception 
(interrupt 0) pushes CS:IP of the in- 
struction that caused the exception. 
The 8086 pushed the CS:IP of the in- 
struction following the instruction that 
caused the exception. 
e Shift counts are masked to 5 bits. 
For example, if you put the value 40 in 
CX and execute 

SHL AX,CX 
the contents of AX will be shifted left 8 
bits. On the 8086, the processor at- 
tempted a left shift of 40 bit positions, 
and the result in AX would always be 
zero. 


Errant Instructions 

There are also some known bugs in the 
80286 revision B chips. 

¢ After execution of POPF, a pending 
maskable interrupt may be improperly 
recognized, even though maskable in- 
terrupts were disabled prior to execu- 
tion of POPF and the flags word 
popped from the stack has IF = O. If 
the interrupt is improperly recognized, 
it will, however, be properly executed. 
This problem is particularly relevant 
for CP/M-86 system users, since many 
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implementations of this operating sys- 
tem run without interrupts; if an inter- 
rupt is unexpectedly serviced, the in- 


given by Intel in its errata sheet: 


CodeMacro POPF ;assume flags on 


terrupt vectors may not have been stack 
initialized, and the system will crash. PUSH CS 

Apparently, this problem occurs CAEE $4:3 ;push IP 
only when the 80286 is running with PUSH BP ;Save BP and 
zero Or one wait states. It can be avoid- MOV BP.SP ‘address the stack 
ed altogether by running the 80286 ;add to IP value on 
with two or more wait states (this, . stack 
however, incurs a significant perfor- sto §=— point __—i past 
mance penalty). Alternatively, you can IRET 


redefine POPF in a way that simulates 


ADD WORD PTR [BP + 2],9 


its action without actually executing POP BP ‘restore BP 
the POPF opcode. There are a couple of IRET ;pop flags, CS, and 
similar ways to do this; here is the one IP 











MEMO: ( Pogrammers 


QUIT 
WORKING 
SO HARD. 


These people have quit working so hard: IBM, Honeywell, Control Data, 
GE, Lotus, Hospitals, Universities & Government Aerospace. 


THE GREENLEAF FUNCTIONS™ 


THE library of C FUNCTIONS that probably has just what you need... TODAY! 


... already has what you’re working to re-invent 
. . already has over 200 functions for the IBM PC, XT, AT, and compatibles 
. already complete . . . already tested .. . on the shelf 
. . already has demo programs and source code 
. . already compatible with all popular compilers 
. . already supports all memory models, DOS 1.1, 2.0, 2.1 
. . already optimized (parts in assembler) for speed and density 
. . already in use by thousands of customers worldwide 
. . already available from stock (your dealer probably has it) 


| . . It’s called the GREENLEAF FUNCTIONS. 


Sorry you didn’t know this sooner? Just order a copy and then take a break — 


we did the hard work. Already. 
THE GREENLEAF FUNCTIONS GENERAL LIBRARY: Over 200 functions in C 


and assembler. Strength in DOS, video, string, printer, async, and system interface. All DOS 1 
and 2 functions are in assembler for speed. All video capabilities of PC supported. 
All printer functions. 65 string functions. Extensive time and date. Directory searches. 
Polled mode async. (If you want interrupt driven, ask us about the Greenleaf Comm 
Library.) Function key support. Diagnostics. Rainbow Color Text series. Much, much more. 
The Greenleaf Functions. Simply the finest C library (and the most extensive). 
All ready for you. From Greenleaf Software. 

... Specify compiler when ordering. Add $7.00 each for UPS second-day air. MasterCard, 
VISA, check, or P.O. 





@ Compilers: @ General Libraries... . $175 


CPCB iS $349 (Lattice, Microsoft, Mark 

== PAUICE os ines $395 Williams, CI C86) 
x Mark Williams ...$475 @ DeSmet C.......... $150 
@ Comm Library...... $160 





GREENLEAF 
SOFTWARE © 


GREENLEAF SOFTWARE, INC. 


2101 HICKORY DRIVE « CARROLLTON, TX 75006 ¢ (214) 446-8641 
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EndM 


¢ The LOCK prefix is ignored in in- 
structions that reference memory only 
once (e.g., MOV reg,mem) but works 
properly for instructions that both read 
and write memory (e.g., ADD mem,reg 
or XCHG mem,reg). Thus, when pro- 
gramming the 80286, you should use 
XCHG to manipulate semaphores. 

¢ The 80286 may fail to generate a pro- 
tection exception in cases where the be- 
ginning of a multibyte operand for the 
80287, addressed via DS or ES, lies 
within an unprotected area but crosses 
into a protected area. Note that this 1s 


only relevant when the system is running 
in Protected Virtual Address mode. 

All three of these problems have re- 
portedly been fixed in 80286 revision C 
parts. Revision B-2 chips can be recog- 
nized by the copyright marking of 
© Intel °83.” 


Added Instructions 

The 80286 microprocessor has several 
new opcodes. Most of them will be use- 
ful only to the authors of compilers or 
device drivers. A few of them, however, 
will be helpful to us average Joes, too. 


Push Immediate Value 





dBASE II outfoxed! 


Who says the most popular database management system is the best? 


Introducing FoxBASE II ‘the new relational database management system that’s 
dBASE II source compatible. It does everything dBASE II does ... plus a whole lot more. 


e Runs 3 to 5 times faster 
e Sorts up to 20 times faster 
e Permits up to 48 fields per 
record ... 50% more than dBASE II 
e Supports full type-ahead 


What’s more, it costs less. 


e Compiles program sources into 
compact object code 

e Comes with a sophisticated online 
manual and HELP facility 

e Has twice as many memory variables 


MS-DOS $395. AOS/VS $995. 


FoxBASE II is available now for: IBM-PC, IBM-PC/XT, COMPAQ & IBM compatibles, TI Profes- 
sional, DG Desktop, DG MV Series, and many others. Call or write today for more information. 


Developed by 


DACOR 


dBASE Il is a registered trademark of Ashton-Tate 
FoxBASE Il is a trademark of Fox Software Inc 





from FOX SOFTWARE INC. 


COMPUTER SYSTEMS 13330 Bishop Road, P.O. Box 269, Bowling Green, OH 43402/ 419-354-3981 / TWX 810-499-2989 
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On the 80286, you can code 
PUSH 4 

which is equivalent to the 8086 
MOV AX,4 
PUSH AX 


Push All (PUSHA) 
This 80286 opcode will push all gener- 
al registers; it is equivalent to the 8086 
code: 

PUSH AX 

PUSH CX 

PUSH DX 

PUSH Bx 

MOV AX,SP 

PUSH AX 

PUSH BP 

PUSH SI 

PUSH DI 


Pop All (POPA) 
This 80286 opcode will pop all general 
registers from the stack; it is equiva- 
lent to the 8086 code: 

POP DI 

POP SI 

POP BP 

ADD SP,2 

POP BX 

POP DX 

POP CX 

POP AX 

Note that the contents of register SP 

that were pushed by the PUSHA in- 
struction are discarded rather than be- 
ing loaded into SP; this, of course, 1S 
vital in saving the stack context. 


Signed Multiply by Immediate Value 
This was one of the more glaring defi- 
ciencies on the 8086; it is remedied on 
the 80286. For example, you can write 

IMUL 10 
where on the 8086 you would have had 
to code something like 

MOV BX,10 

IMUL BX 


Shift/Rotate Memory or Register by 
Count 
For example, on the 80286, you can 
code 
ROL AX,3 
where on the 8086 you would have to 
write either : 
MOV CX,3 
ROL AX,CX 
or the sequence 
ROL AX, | 
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UNIX™ Technology for CP/M™ 


ConIX can provide any 48K+ CP/M-80 system with many 
advanced capabilities of UNIX. You'll be amazed at what 
your CP/M micro can do now! ConIX features include: 


I/O Redirection and Pipes (uses memory or disk), multiple 
commands per line, full upper/lower case and argument 
processing, Auto Screen Paging, Programmable Function Keys, 
i frcanee User Area Directory manipulation, Command and 
Extension (Overlay) Path Searching, “Virtual” disk system, 
8Mb Print Spooler, extensive preprocessed “Shell” command 
programming language, 300+ variables, over 100 built-in 
commands, Math Package, 22 new BDOS SysCalls, Archiver 
(compacts files for disk Space savings of over 50%), On-Line 
Manual System, and much more! Uses as little as 1/2K RAM! 
Runs with CP/M for true data and software compatibility. 
Installs quickly and easily without any system modifications. 


The ConIX Operating System 
List Price: $165 
Price includes Instructional Manual, 8” SSSD disk and free support. 
Format conversion available. To order, contact your local dealer, or 


buy direct and add shipping: $4.50 UPS, $10 ada, $25 overseas, 
COD $2 extra (USA only). NY State residents add sales tax. 
Tel. (212) 652-1786 


Dealer inquiries invited! 


UNIX: AT&T Bell Labs, CP/M: Digital Research, ConIX: Comp. Helper Ind. Inc. 


Computer Helper Industries Inc. 
P.O. Box 680 Parkchester Station, NY 10462 
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Z80ASM 















© Complete Zilog ° Conditional assembly 
Mnemonic set e Assemble code for 

e Full Macro facility execution at another 

@ Plain English error address (PHASE & 
messages DEPHASE) 

© One or two pass e Generates COM, HEX, 
operation or REL files 

*° Over 6000 lines/minute | ® COM files may start at 

© Supports nested other than 100H 
INCLUDE files ¢ REL files may be in 

¢ Allows external bytes, pe gts abeaheciag oe 
words, and expressions 
(EXT1 * EXT2) © Separate PROG, DATA 





© Labels significant to 16 & COMMON address 


characters even on SRAGCS i 
externals (SLR Format ° Accepts symbol defini- 
Only) tions from the console 


® Integral cross-reference ° Flexible listing facility 


includes TIME and 
: Sotocaiy nificant DATE in listing (CP/M 
me ies Plus Only) 











For more information or to order, call: 


1-800-833-3061 


In PA, (412) 282-0864 


Or write: SLR SYSTEMS 
1622 North Main Street, Butler, Pennsylvania 16001 


ConlX 


Six Times Faster! 


Super Fast Z80 Assembly Language Development Package 
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Hello, 

’'m Bill Salkin 

As editor of PC 
FIRING LINE/PC 
UNDERGROUND, 
the bi-monthly tech- 
for the IBM PC, | k : 
invite you to join us } 
as we discuss critical "zits asco . 
error-handling routines, bicubic splines, drool |. 
over ‘printf’ source code, share FREEWARE, _ 
provide programmer-oriented DEMOS and tips, | 
dissect utilities like the DOS 2.x EXEC function, } — 
continue our ADA, ASM, C, FORTH, and LISP 
tutorials, and more! Sizzling ready-to-use source | 
code included in each jam-packed issue (Cur- 
rently 2 DS/DD disks per issue!) 
e Price: $12 per issue, or $72 for a one-year (six-issue) 
subscription. Make checks payable to ABComputing. (All 


currency in U.S. dollars. Foreign countries send money 
orders and add $5 airmail for each issue.) 


¢ Make non-profit copies for your friends. Those receiving 
these copies are asked to pay us $6 to help defray our 
Production costs. Make checks payable to ABComputing. 


e Requires 128K RAM. any release of DOS, and one 
double-sided disk drive. Note: We ship ONLY DS/DD disks. 


ABComputing 
Dept. 50, P.O. Box 5503, North Hollywood, CA 91616-5503 
(818) 509-9002 
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SLRNK 


@ Links any combination © COM may start at 
































of SLR format and other than 100H 
Microsoft format REL e HEX files do not fill 
files empty address space. 
e One or two pass e Generate inter-module 
operation allows output cross-reference and 
files up to 64K load map 
© Generates HEX or COM_e Save symbol table to 
files disk in REL format for 
e User may specify PROG, use in overlay 
DATA, and COMMON generation 






loading addresses 


a, wat alee y 
ih Whsihpoyy’ 


REED 
¢ Complete Package Includes: Z80ASM, SLRNK, SLRIB 

- Librarian and Manual for just $199.99. Manual only, $30. 
¢ Most formats available for Z80 CP/M, CDOS, & TURBODOS 
¢ Terms: add $3 shipping US, others $7. PA add 6% sales tax 


_ © Declare entry points 
from console 
© The FASTEST Micro- 
soft Compatible Linker 
available 























ROL AX, |} 
ROL AX, 1 


Input and Output String (INS and 
OUTS 

These are new members of the string 
instruction group that also includes 
MOVS, CMPS, SCAS, LOS, and STOS. 
INS transfers data from the port num- 
ber in the DX register to the memory 
address represented in ES:DI, while 
OUTS transfers data from the memory 
address represented in DS:SI to the 
port number that is in DX. Both INS 
and OUTS can transfer either byte or 
word values and can accept a REPeat 
prefix that is controlled by the contents 
of CX and causes autoincrement or au- 
todecrement of the appropriate index 
register, depending on the state of the 
direction flag. 


Enter Procedure (ENTER) 

This creates a stack frame and initial- 
izes a frame pointer. It was added to 
support the compilation of procedures 
in block-structured, high-level lan- 
guages such as PL/I, Pascal and (God 
forbid) Ada. 3 


Leave Procedure (LEAVE) 

This releases a stack frame and re- 
stores the previous contents of the 
frame pointer. It reverses the effect of 
ENTER. 


Detect Value out of Range (BOUND) 
This tests whether an array index falls 
within the range defined by the con- 
tents of a two-word block of memory; 
if not, an interrupt 5 occurs. 

There are also 16 new instructions 
concerned with task concurrency and 
memory protection that are beyond the 
scope of this column. They load or 
store global, local, or interrupt descrip- 
tor registers, control write access to re- 
gions of memory, and change task 
privilege levels. There is also a raft of 
new ways you can use familiar instruc- 
tions (such as IRET) to generate pro- 
tection exceptions. These we'll leave 
for a later, more profound, column. 


New Interrupts 
The 80286 adds nine new hardwired 
interrupts to those defined on the 8086. 
These are: 
Interrupt Cause 

5 BOUNDS executed with ar- 
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ray index out of range 


6 Execution of undefined 
opcode 
7 Coprocessor protection er- 


ror, relevant in Protected 
Virtual Address mode 

8 Interrupt table limit fault, or 
the dreaded Double Fault 
(e.g., protection fault fol- 
lowed by segment not pre- 
sent fault, such as might be 
caused if the protection fault 
interrupt handler had been 
paged out by the virtual 
memory manager) 

9 In Real Address mode, co- 
processor data transfer wrap- 
around past offset OFFFFH. 
In Protected mode, this 
exception will also occur if 
the first part of a multi- 
byte 80287 operand falls 
within an unprotected area 
but crosses into a protected 
memory area 

10 Invalid task state segment; 
attempted to switch context 
to a task with an illegal de- 


scriptor, Protected mode 
only 
11 Memory segment not pre- 


sent—support for virtual 
memory manager, Protected 
mode only 

12 Stack fault—stack overflow 
or underflow, or stack refer- 
ence to a memory segment 
not present, Protected mode 
only 

13 In Real Address mode, seg- 
ment wraparound attempted 
by a word operation at offset 
OFFFFH, or a stack push 
with SP = 1 during PUSH, 
CALL, or INT. In Protected 
mode, general protection 
fault; any memory protec- 
tion exception not covered 
by the other error interrupts. 


Faster Microcode 

Many of the 80286’s instructions that 
are functionally identical to the 8086 
actually execute much faster due to im- 
proved implementation. For example, a 
16 X 16-bit register-register signed 
multiply, which requires 128 — 154 
clocks on the 8086, requires 21 clocks 
on the 80286. This concludes our Sneak 
Preview of the Intel 80286 CPU. More 


to come in subsequent columns. 
Determining PC Type 


As the IBM PC family proliferates, 
software developers will need a way to 
determine the type of host machine at 
runtime. IBM has declared that the 
ROM location F000:FFFE may be in- 
spected by software and that its con- 
tent has the following meaning: 


Contents Machine 
OFF IBM PC 
OFE PC/XT 
OFD PCjr 
OFC PC/AT 


It would be helpful to know what 
this location contains on other IBM 
PC-like models such as the 3270PC 
and the vast family of IBM-compati- 
bles. My Compaq (an early model, 
ROM copyright 1982) has 02DH at 
this location. 


if | Had a Hammer 


Russ Hayden of Natick, Massachu- 
setts, writes: ‘‘...in the June 1984 in- 
stallment of the 16-Bit Software Tool- 
box, there are some 8086 assembly 
routines to convert binary values to 
ASCII hexadecimal. Ray, if these tools 
were screwdrivers, they would be made 
of tinfoil. It’s not that they don’t work 
(they'll execute fine), but rather the 
use of the ‘DIV’ (divide) instruction to 
divide a binary number by 16, where 
four right shifts will accomplish the 
same purpose. The DIV instruction 
takes 90 clocks in 8086; four right 
shifts take a total of eight clocks. 

“I don’t think we’ve reached the 
point in processing power where such 
things no longer matter, especially in 
routines likely to be incorporated into 
larger programs and used frequently. 
A column on tools should be sensitive 
to the many ways to approach a prob- 
lem and their relative merits. [I’ve en- 
closed] a suggested improvement in 
the byte_to_hex routine.” 

It’s really embarrassing to be caught 
out on this. I’ve always been a fervent 
advocate of using shifts and avoiding 
hardware divides whenever it’s re- 
motely feasible. Oh well, see Listing 
Three (page 93). DDJ 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 197. 
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FORTRAN PROGRAMMER 


Lahey Computer Systems is pleased to announce 


F774 


the complete implementation of the ANSI 
FORTRAN 77 standard for the IBM PC and compatibles. 


With fast compile and execution speeds, specific diag- 
nostics at compile and runtime, F77L meets the needs of 
mainframe programmers who recognize FORTRAN as 
the workhorse of computer languages. In addition to 
meeting the '77 Standard, F77L features include: 


@ Many IBMH features: $in aname,8 character names. Types: 
LOGICAL*1, REAL*8, INTEGER*2, COMPLEX* 16. 

@ INCLUDE, OPTION, and CHAIN statements. 

®@ Optional checking: subscript, subprogram class, argument 
and alternate return count. 

@® Runtime messages include text and subprogram/line-number 
traceback. 

@ COMMONS and subprogram units may be as large as 64K. 

@ Source file is free format: comments begin with asterisk, 
continuation lines begin with ampersand. 

®@ Complete and easy to follow 250 page manual. 

@ Telephone user support and newsletter with updates. 


When you purchase the F77L you are buying more than a 
language system you are also buying LCS’s commitment to 
FORTRAN programming. We have specialized in FORTRAN 
since 1969 and were the first to implement FORTRAN 77. 
Because we sell only one product, our customers know that our 
total effort is directed towards the development of F77L and the 
continuing service of our users. 

If you are serious about FORTRAN programming, then you 
owe it to yourself to compare Lahey Computer Systems’ F77L to 
the competition. 

Complete package: $477. Visa/MC 
To order or for more information call or write: 


Lahey Computer Systems, Inc. 
904 Silver Spur Road, Suite 417 
Rolling Hills Estates, CA 90274 (213) 541-1200 
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WRITE 


The Writer's Really Incredible Text Editor lives up to its 
name! It’s designed for creative and report writing and 
carefully protects your text. Includes many features 
missing from WordStar, such as_ sorted directory listings, 
fast scrolling, and trial printing to the screen. All editing 
commands are single-letter and easily changed. Detailed 
manual included. Dealer inquiries invited. WRITE is 
$239.00. 


BDS’s C Compiler 


This is the compiler you need for learning the C language 
and for writing utilities and programs of all sizes and 
complexities. We offer version 1.5a, which comes with a 
Symbolic debugger and example programs. Our price is 
(postpaid) $130.00. 


Tandon Spare Parts Kits 


One door latch included, only $32.50. 
With two door latches $37.50. 
Door latches sold separately for $7.00. 


All US orders are postpaid. We Ship from stock on many 
formats, including: 8", Apple, Osborne, KayPro, Otrona, 
Epson, Morrow, Lobo, Zenith, Xerox. Please request our 
new catalog. We welcome COD orders. 


Workman & Associates 


112 Marion Avenue 
Pasadena, CA 91106 
(818) 796-4401 
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Including a new dynamic debugger 
Still the choice of professionals 


* Compiler option to generate special ¢ Clink option to suppress 
symbol table for new dynamic warm-boot 
debugger by David Kirkland. (With the 


New li f aes 
debugger, the distribution package Linen vorety Me saarehccapaniiges 


now requires two disks.) * New, fully-indexed 180 page manual , 
* Takes full advantage of CP/M® 2.x, °° CPIM is a trademark of Digital 
including random-record read, seek Research, Inc. 


- relative to file end, user number 
prefixes, and better error reporting. 


V1.5 .....$120.00 
V146 ....$115.00 


(needs only 1.4 CP/M) 


Other C compilers and 
C related products 
available .. . Call! 


TERMS: CHECK, 
MONEY ORDER, C.O.D.., 
CHARGE CARD 
HOURS: 9 am—5 pm 
Monday —Friday 


(316) 431-0018 










IT’S HERE! 


MONEY MATH 


¢ Uses BCD internal 
representation. 







* You choose from two types 
of rounding. 





* Configurable exception 
handling 

* Distributed with 12 digits 
precision. Easily configured 
for more or less 








* Excess 64 exponents 


incLUDED $500 


oS ay SY 
Dedicated Micro Systems. Inc. 


P.O Box 481, Chanute, Kansas 66720 


include $2.50 for postage and handling 















Y 


SSF] 
SR SF PORES | 25 
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A Professional Quality Z80/8080 Disassembler 


REVAS Version 3 


Uses either ZILOG or 8080 mnemonics 
Includes UNDOCUMENTED Z80 opcodes 
Handles both BYTE (DB) & WORD (DW) data 
Disassembles object code up to 64k long! 
Lets you insert COMMENTS in the disassembly! 










A powerful command set gives you: 


INTERACTIVE disassembly 
Command Strings & Macros 
On-line Help 
Calculations in ANY Number Base! 
Flexible file and I/O control 
All the functions of REVAS v2.5 


REVAS: 


Is fully supported with low cost user updates 
Runs in a Z80 CPU under CP/M’* 
Is normally supplied on SSSD 8” diskette 


Revas V 3...$90.00 Manual only...$15.00 
California Residents add 6%% sales tax 


REVASCO 
6032 Chariton Ave., Los Angeles, CA. 90056 
(213) 649-3575 



















*CP/M is a Trademark of Digital Resaerch, Inc. 
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a. ie otee 5 : 7 6- B 7 t (Text beens nace 58) 


op Mops RS | Listing One 


greene f Le What's wrong with this picture? 


MC: Fe Fn ea 7 fen ee ay i ie r O° 1 1 p r ° c ne a r : e x t r a c t wo r a n £ r om th e 
of Fe ky ve ee ;depths of the parameter 
Net [LLL mag 1 ae ;stack, pushing it on top 






we) A 2 , pop bx ;get return address out 
ae aa ee | og i a mov ax,ss scan't override ES, so 
a fe Ne Ge mov eS,ax smake it address stack segment. 
WNW ; pop di ;get number of stack cell 
—~ an iS mA ;to bring to the top. 
Sages, ait mov cx,di ;calculate number of stack 
ine Ox swords to slide. 
sal di,l scalc destination address 
add di,sp ;for slide. 
t, compile a mov si,di scalculate source address 
program from inside the EC editor.* In sub si,2 ;for slide. 













































fact, EC gives you complete access to the 
operating system. Do a directory, copy 
or delete files, even run other programs 
without ever leaving EC! 


MULTIPLE WINDOWS— 
Forget about dumping a file you're editing 


push ss: [di] scopy the desired cell to 
;top of stack. 

std sset direction flag for 
string move. 
snow slide the stack. 

rep movs es:word ptr [di],ss:word ptr [si] 


just so you can see what is in another add ee 2 fab gage ve ary pointer. 
file ... open a new window, up to five of YT raitg * FrecurN cto carter. EO 
them, and read in the file you want to use. CO, a ENCE End Listing One 


All windows can be shown on the screen 
at the same time; or the screen can be 
dedicated to just a single file, while 

the others are kept in the background— 
only a keystroke away. You can even cut 
and paste blocks of text between 
windows! 

FULL SCREEN EDITOR FOR THE IBM— 
Developed specifically for the IBM PC, EC 


makes extensive use of the entire PC 
keyboard so editing is fast and intuitive. 


Listing Two 
What's wrong with this picture? 


mov bx,sp 


In addition to standard editing features, EC wait : 

supports command and text macros, word fld ss: es 

wrap, paragraph reformatting, horizontal add sp, 

scrolling, and control for color monitors. 

DEMO DISK IS ONLY $5— 3 End Listing Two 
Call or write for our full-featured demo. 

You'll get a standard version of EC that 

handles up to 10K worth of files and a 

complete set of documentation. L isting Three 


See for yourself how pleasant it is to use 
an editor that gives you both unrestricted 
access to the operating system and 
multiple windows. 


Improved conversion routine (see also column in June DDJ). 


You won't be disappointed! byte to hex proc near sconvert binary value to 


;hex ASCII 
;AL=binary value 
;DI=pointer to storage 






EC EDITOR - $125 
EC DEMO - $5 (plus $1.65 for COD) 








; for string 
mov ah,al ssave lower nibble 
* EC runs on an IBM PC, or look-alike, with at least shr .aisgs sdivide upper nibble by 16 
128K RAM under DOS 1.1 or higher. To use the shr alot : 
DOS interface feature you must have DOS 2.0 or hr l ‘ 1 
higher and enough RAM to run the additional 5 oh 
program. shr al,l 
. call ascii sconvert it to ASCII 
IBM is a trademark of International Business Machines stosb sand store it 
; N % “ 
MG; RESIDENTS APE e.Setee mov al,ah ;get back lower nibble 
' and al,@fh smask to four bits 
call ascii sconvert and store 
OURCE stosb 
ret 
C SOURCE byte to hex end nts 
12801 Frost Road e Kansas City, MO 64138 yee) — e End Listings 


816-353-8808 
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GGM — FORTH™ has HELP* 
for Z80' using CP/M? 












QUALITY SOFTWARE AT 
REASONABLE PRICES 
CP/M Software by 
Poor Person Software 
Poor Person’s Spooler $49.95 


All the function of a hardware print buffer at a fraction of the 
cost. Keyboard control. Spools and prints simultaneously. 


# Poor Person’s Spread Sheet $29.95 


Flexible screen formats and BASIC-like language. Pre- 
programmed applications include Real Estate Evaluation. 


Poor Person’s Spelling Checker $29.95 
Simple and fast! 33,000 word dictionary. Checks any CP/M 
text file. 


aMAZEing Game $29.95 


Arcade action for CP/M! Evade goblins and collect treasure. 






























GGM—FORTH, a complete software system for 
real-time measurement and control, runs on any | 
280 computer under CP/M using an extended fig-| 
FORTH vocabulary. 


GGM—FORTH features: 


e Open multiple CP/M files, in any combination | 
of direct-access and sequential-access, fully 
compatible with all CP/M utilities 


e Char. in/out uses CP/M console, lister, file, or] 
port : 


1 © On-line HELP* provides instant access to defi- 






















































Creccword Game $39.95 nitions in the run-time GGM—FORTH dic- 

Teach spelling and build vocabulary. Fun and challenging. tionary 

Mailing Label Printer $29.95 8 HELP* file is easily extended to include user 
Select and print labels in many formats. : definitions using HELP* utility 

Window System $29.95 ¢ HELP* is available during full-screen editing 


Application control of independent virtual screens. 


All products require 56k CP/M 2.2 and are available on 8” IBM and 5” 
Northstar formats, other 5” formats add $5 handling charge. California 


Complete system and manuals $150. 






residents include sales tax. Manuals only: $ 20. 
Sint Sie ING ive GGM SYSTEMS, INC. (617) 662-0550 
ees he oe tee 135 Summer Ave. Reading, MA 01867 


CP/M is a registered trademark of Digital Research 








| '280 is a trademark of Zilog, Inc. 
*CP/M is a trademark of Digital Research, Inc. 
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Get Fast Relief! 


5-100! IBM PC/XT! TRS’80 II! EPSON QX10! ZENITH Z-100! 


If you've been “patient” with slow 5S-100 applications. 
disk drives for too long, SemiDisk 
will relieve your suffering. 










surface, and a floppy, which grinds 
the disk constantly, the SemiDisk 


Contains gentle buffers. ives you ultra-fast, silent data 
transfer. 









Fast-acting. CP/M®80 installation software 
includes SemiSpool, which buffers ere tes Pe ae 
The SemiDisk, a super-fast disk print data in the SemiDisk. This And SemiDisk’s price won't raise 






emulator, stores and retrieves data allows the computer to be ready for YOUr blood pressure. 
much faster than either a floppy or other uses immediately after issuing 











hard disk. a print command. 
512K 1Mbyte 
; SemiDisk I, S-100 $995 $1795 
Rasy to apply. No emulator amnesia. seminiskt.$-100 $1248 $2095 
Installation is as easy as plugging —_— The optional Battery Backup Unit ¢™miDisk, TRS-80 II $995 $1795 
the SemiDisk into an empty slot of | (BBU) plugs into the SemiDisk, and Semmil isk, IBM PC $945 $1795 
your computer, and running the supplies power even when the SemiDisk, Epson QX10 $995 
installation software provided. computer is off. A battery keeps the S¢miDisk, BBU ap0 







data alive during power outages of 
Regular four hours or more. 


and extra-strength. 








Stops head-aches. 


SemiDisk I is the standard model 


for S-100, SemiDisk II offers extra Unlike a hard disk, which can SemiDisk Systems; Ine. 
‘bility f ‘crash’ its head on the rotating disk P.O. Box GG, 

speed and flexibility for custom Beaverton, Oregon 97075 

503-642-3100 







Call 503-646-5510 for CBBS/NW and 503-775-4838 for CBBS/PCS. both SemiDisk-equipped computer bulletin boards 
(300/1200 baud). SemiDisk, SemiSpool trademarks of SemiDisk Systems. CP/M trademark of Digital Research. 
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C/UNIX PROGRAMMER’S NOTEBOOK 





by Anthony Skjellum 


In this column, we'll consider some 
reader feedback on material presented 
in earlier columns. First, I will mention 
some new volumes available from the 
C User’s Group. Following this, [ll 
present some corrections to errors in 
previous columns. 


CUG Volumes 
Machine-readable software can help 
you avoid a lot of frustration. To help 
readers of this column, I have created 
two C User’s Group volumes: CUG 
DDJ, Volumes | and 2. They contain 
material up to and including the Octo- 
ber 1984 column. The group’s new ad- 
dress 1s: 

C User’s Group 

415 East Euclid 

McPhearson, KS 67460 

(316) 241-5450 

Volumes are available in several for- 

mats, including IBM PC and popular 
54-inch CP/M-80 formats (e.g., Os- 
borne DD). Contact Robert Ward at 
the above address for details. 


Runge-Kutta Correction 
Three errors were evident in the Octo- 
ber column. The differential equation 
used in the example (from page 94) 
should have been 

y(t)=I1+t-—y 
and not 

WAU 1 EY. 
as printed. Furthermore, the solution 
to this equation is 
y(t) = t + 5.0°exp( —t) 
for the initial condition yO = 5.0. 
Also, the display( ) function on page 
98 of the October issue is corrected in 
Listing Three (page 102) of this issue. 


X Grammar Examples 

Some of the examples presented in the 
September column were set incorrect- 
ly. The errors principally involve the 
omission of semicolons at the ends of 
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certain lines. For example, in Figure 1, 
page 116, there should be a semicolon 
following the word COMPLEX. Fur- 
thermore, both assignment statements 
in the first cadd( ) function of Figure 2 
are missing their semicolons. Figure 3 
is missing its terminating brace. Final- 
ly, an errant semicolon appears on the 
first line of Figure 5. 


Long Pointer Corrections 
I presented a Long Pointer package in 


proc near 
or 

jnz 

mov 

sub 

mov 

dec 
ret 
end 


the June column. Bruce Komusin 
wrote from Monaco to point out some 
errors in the assembly language rou- 
tines. He writes: 

“I just read your article in DDJ #92 
about long pointers for C. I never 
[have] used C, but I know 8086 assem- 
bler. From your listing of llsup.asm, it 
is apparent that you overlooked the 
fact that the 8086 affects the flags 
when doing INC or DEC [instructions] 
for 16-bit [quantities]. This is a com- 


bx, bx 
Idec__1 
ax,eS 

ax, 1000h 
es,ax 

bx 


ao 
Figure 1 


vec int sort_them(argent, argvec) 


int argent; 


int *argvec|]; /* Integer arguments */ 


{ 
Je 


* exchange the values of the argvec array 


* here 


* 


l 





Figure 2 


vec int sort_them(argcnt, argvec) 


int argent; 
int *(argvec[O]){ ); 
int *argvec{]; 


T etc. / 


/* The rest are integers */ 





Figure 3 
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mon error because it is different on the 
8080. So, for example, you can save 
bytes and time in the routine line by 
removing the OR BX,BX.” 

While this concerns only inefficient 
coding, Mr. Komusin continues to 
point out a real bug: 

“However, I really wrote this letter 
to warn you about Idec. Of course, it 
will not work as is because of the DEC 
BX changing the zero flag set up by 
the OR BX,BX. I suggest a change... 
that fixes everything.” 

The change is presented in Figure | 
(page 96). Beyond the basic fixes, Mr. 
Komusin suggests some increases in 
efficiency: 

“However, here are some points 
about execution speed and byte effi- 
ciency. It is much faster to ‘fall 
through’ a conditional jump than to 
actually jump. So, if possible, it is al- 
ways a good idea to arrange the code so 
that the normal case falls through and 
only the exceptional case jumps. As a 
side benefit, the exceptional case can 
then be shared.” 

A full set of improved routines are 
presented in Listing | (page 97). I 
want to thank Mr. Komusin for his let- 
ter and corrections. 


Programming Philosophy 

John A. Grosberg of Scottsdale, Arizo- 
na, wrote an interesting letter concern- 
ing programming style and philosophy. 
He wrote his letter after reading the 
August 1984 column, which included a 
short listing by Alex Cameron. Mr. 
Grosberg writes: 

“Your column ... caught my atten- 
tion, particularly the short listing of 
Mr. Alex Cameron’s routines to auto- 
matically allocate I/O buffers (page 
119). I am writing to present a few 
ideas on program structure and will use 
his listing as an example. This is not an 
attack on his application or on the style 
he used in his listing—I assume that 
there were reasons for the form chosen. 
But my perfectionism was provoked by 
that listing, and the more I read it, the 
more I wanted to write. 

“One important principle of pro- 
gram design is that the structure of the 
program (I will use program, routine, 
and function interchangeably for this 
discussion) should reflect the structure 
of the problem. This sounds nice, but 
what does it mean? Without guidelines 
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it is almost a theological principle, over 
which well-meaning people could ar- 
gue loud and long and never come to 
agreement. The reason for this is that 
the ‘structure of the problem’ depends 
on one’s viewpoint; i.e., it is relative to 
the observer ... the program’s struc- 
ture reflects the way we are thinking 
about the problem.” 

Since the way we write programs is 
based on our viewpoint, Mr. Grosberg 
Suggests a set of standard reference 
points: 

“In mechanical drafting, there are 
three standard orthogonal viewpoints 


that are used to describe most objects. 
They are called ‘front,’ ‘side,’ and ‘top’ 
views of the object. The structure of 
the physical object inheres in the spa- 
tial relationships of its elements, and 
these must be captured in the drawing. 

“In software, an important aspect of 
structure is the temporal relationships 
among the elements. The two primary 
temporal relationships are sequence 
and frequency, and these relationships 
should be captured in the code. If one 
action occurs before another in time 
(sequence), then the first should pre- 
cede the second in the code. If an action 


vec char *dunno(argent, argvec) 


int argent; 

*argvec(O]; 

*argvec| 1]; 

*argvec[2]; 
[3] 
| 


char 

long 
double 
COMPLEX 


a *argvec|]; 


/* 


*argvec[3]; 


/* rest are integers */ 


" Here we have a function whose first four arguments 
* are respectively: char, long, double, and COMPLEX 
* pointers. Anything after that is an integer 


a, 


Figure 4 





improvements to Ilsup routines by Bruce Komusin 


% Microworld 
L'Estoril 


31 Ave. Princesse Grace 


Monte Carlo, Monaco 


these routines offer more temporal and byte-efficient 
code than those originally presented in llsup.asm 


Idec proc 
or 
jz 
dec 
ret 
Idec_2 dec 
Idec_3 mov 
sub 
mov 
ret 
endp 


proc 
sub 


endp 
Listing One 


near 
bx,bx 
idec_2 
bx 


bx 

ax,es 

ax, 1000h 
eS,ax 
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Applications Developers 


VC" UN BOCTRE: FUT ORE 






The first DBMS 
designed exclusively 
for the C language. 


C is the applications development lan- 
guage chosen by many of the largest and 
most successful microcomputer software 
houses. Now with db__VISTA, C can be 
your development language choice, too. 


db__ VISTA is the database management 
system that helps you easily define and 
manage databases — no matter how 
complex your information structuring 
requirements. Features include: 

































Written in C, under Unix. 
* Minimal data redundancy using 
the network database model. 

* Virtual memory disk accessing. 

* Fast B*-tree indexing method 
for key files. 

* Multiple key records--any or all 
data fields may be keys. 

* Unlimited runtime distribution 
license available for $795. 

* Three month extended 
applications support included. 

* PC-Write word processor/text 

editor included at no charge. 


MONEY-BACK GUARANTEE 


For Lattice C, DeSmet C, or Computer 
Innovations’ C86 under MS-DOS, with 
thirty day money-back guarantee. Availa- 
ble soon for Unix/Fortune 32:16, Xenix/ 
Altos 586, and CTOS/Convergent Technol- 
Ogies systems. 


db__VISTA versions 


Lattice 
DeSmet 495 





Computer Innovations 495 

db__VISTA Manual 45 
Development Packages: 

Lattice C w/db__VISTA $795 

Lattice C only a 


DeSmet Cw/db_VISTA C w/db__VISTA 


R4AINNA 


CORPORATION 
11717 Rainier Avenue South 
Seattle, WA 98178 
206/772-1515 
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occurs the same number of times (fre- 
quency) as another, then they should be 
in the same (logical) block of code.” 

I think that Mr. Grosberg’s recom- 
mendations are practical. In my opin- 
ion, this type of coding technique could 
only improve maintainability of soft- 
ware. He continues: 

‘Expanding on the concept of tem- 
poral relationships as expressed in 
code, consider that on any single exe- 
cution of a program, an element of that 
program may be executed once, more 
than once, or less than once [i.e., not 
executed]. If the element executes 
once and only once per program execu- 


#define NULL 0 
#define BUFSIZ 256 
#define TRUE 1 
#define ERR -] 


sfopen(filename, mode) 
char “filename; 
char *mode; 
{ 
int fd, 
err; 
if (fd = alloc(BUFSIZ)) 
{ 


switch(*mode) 


tion (sequence), it should simply be 
listed in sequence where it belongs. If 
the element executes more than once 
per execution (repetition), it should 
appear once in a loop. If the element 
executes less than once per program 
execution (alternation), it should ap- 
pear once in a program branch state- 
ment. Finally, all elements that exe- 
cute the same number of times should 
appear together in the listing.” 

While these points seem obvious to 
me (and also to Mr. Grosberg), it is 
clear that they are not often followed. I 
cannot claim to have adhered to these 
principles in the past, although I plan 


case W: /* write mode */ 
err = (fcreat(filename,fd) = = ERR); 
break; 

case Tr: /* read mode */ 
err = (fopen(filename,fd) = = ERR); 
break; 

case a: /* append mode */ 


err = (fappend(filename,fd) = = ERR); 


break; 
default: /* invalid mode */ 
err = TRUE: 
break; 
} 
if (err) 
free(fd); 
fd = NULL; 
} 
: 
else /* alloc failure */ 
{ 
fd = NULL; /* redundant */ 
return(fd): 


Listing Two 


* 


Revised <untested> version of ‘‘sfopen.’ 
and published in DDJ, August 1984. 


‘ The original version was written by A. Cameron 


This revision is to illustrate the design principle that the structure of a program should reflect 
the behavior of the program (a corollary of the principle that the structure of a solution should © 


reflect the structure of the problem). 


The focus of this example is that the execution sequence and execution frequency are primary _ 
elements of problem structure and should be mirrored in the code. 


by John A. Grosberg 
[relevant for BDS C] 
| 
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Announcing a 


TOTAL PARSERGENERATOR SMALL FOR IBM-PC 


<GOAL> :: = <RAPID> <COMPILER> <DESIGN> 


SLICE YOUR COMPILER 
DEVELOPMENT TIME 


An LR(1) parser generator and several sample compilers, 
all in Pascal for your microcomputer. 













SMall-C Compiler Version 
2.1 for PC-DOS/MS-DOS 
~ Source Code included 
_ for Compiler & Library 
New 8086 optimizations 
Rich I/O & Standard Library 

















Generates parser, lexical analyzer and skeleton 
semantics 

Universal, state-of-the art error recovery system 
Adaptable to other languages 

Interactive debugging support 

Thorough documentation 

TURBO PASCAL™ INCLUDED FREE OF CHARGE 
Includes mini-Pascal compiler, assembler, simulator 
in SOURCE 


SPECIAL INTRODUCTORY OFFER $1995 


QPARSER™ runs on IBM PC/DOS in Turbo Pascal. Parser generator in object form; all else in source 
QPARSER takes a grammar and generates a correct, complete, high-performance compiler with skele- 
ton semantics in Pascal source. Easy to add full semantics for YOUR application. Excellent for industrial 
and academic use. An accompanying textbook (SRA publishers) available in 1985. Training can be 
arranged. Demo Disk availble for $50.00. 












































CBUG SOURCE LEVEL DEBUGGER FOR S 


Break, Trace, and Change 
variables all onthe 
source level 
Source code included 


Dataligh 


11557 8th Ave. Py. 
Seattle, Washington 98125 


oY coer eerie ANIC (206) 367-1803 


1164 Hyde Ave., San Jose, CA 95129 


TOLL FREE: 800-538-9787 


California residents call 408/255-5574) 
™ Turbo Pascal is a registered trademark of Borland International. 





MALL C 































Educational and quantity discounts available. Check, money order, Mastercard, Visa. California resi- 
dents add 6.5% sales tax. 


WRITE OR CALL FOR FREE BROCHURE. 
Technical details: call 408/255-5574. Immediate delivery. CALL TODAY! 














__ ASMorMASNM is required with compiler. 

Include disk size (160k/3 20k), and DOS version with order 

VISA & MasterCard accepted. Include card no. & expiration date 

__ Washington state residents include 7.9% sales tax. 

IBM-PC & PC-DOS are trademarks of International Business Machines 
__ MS-DOS is a trademark of Microsoft Corporation. 
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The Little Board™ ...$349* 


The world’s simplest and least expensive CP/M computer 


Circle no. 76 on reader service card. 








BUFFERED I/O BOARD Introductory Price * $59.95 
With despool functions, protocols supported: XON/XOFF. ETX: ETB/ACK 


{8} 
Parallel 
Out 
































Serial I/O 
1100-19200 Baud 


Serial I/O 
110-19200 Baud 





Parallel 
In 







TCPM % 22 











































Programmable Z80 Control 64K NI ev ot 
Timer Processor Buffer RAM yo ow 
N 
0 oo 
2K Program EPROM \ 
Vectored S-100 Interface Programmable Functions 
Interrupts 16 Bit I/O Addressing Dynamic Buffering 












80 CHARACTER VIDEO BOARD * $49.50 


25 Lines with status, compatible with Wordstar & dBase 


2716 Char. | | 2716 Alternate Bell Keyboard 
Generator Character Out Parallel 






CP/M 2.2 


INCLUDED 















“UNDER $200 IN 
OEM QUANTITIES 


EPROM Gen. EPROM Port 











8275 CRTC 
Reverse Video Bult 
Highlight, Blink wires 


Screen 2K Program a re Memory 
RAM EPROM Addressing Mapped I/O 
Includes Bareboard, Heatsink & Documentation Call or write for more information. 


Simplimay Products Ca. Sata 
\ @ \ DO Bu 601 es 
Woflman Estates, /L.6OIGS | mmm 


(312) 359-7337 eee 


OEM dealer pricing available, $3.00 S/H, IL. Res. add 7% tax | 
dBase™ - of Ashton- Tate Corp. — Wordstar™ - of Micropro Int'l. Corp t 







e 4 MHz Z80A CPU, 64K RAM, Z80A CTC, 2732 Boot ROM 
e Mini/Micro Floppy controller (1-4 Drives, Single/Double Density, 1-2 sided, 40/80 track) 
© Only 5.75 x 7.75 inches, mounts directly to a 5 1/4” floppy drive 
@ 2 RS232C Serial Ports (75-9600 baud & 75-38,400 baud), 1 Centronics Printer Port 
e Power Requirement: +5VDC at .75A; +12VDC at .05A/On-board -12V converter 
e CP/M2.2BDOS e ZCPR3CCP e Enhanced AMPRO BIOS 
e AMPRO Utilities included: 
e read/write to more than 2 dozen other formats (Kaypro, Televideo, IBM CP/M86....) 


e format disks for more than a dozen other computers 
® menu-based system customization 


e BIOS and Utilities Source Code Available 


e SCSi/PLUS Adapter: 
© Mounts directly to Little Board e Slave |/O board control e Full ANSC X3T9.2 
® 16 bidirectional I/O lines e $99/Quantity 1 


Distridutor/Dealer/Reps 
Z80A is a registered trademark of Zilog, Inc. 
COMPUTERS. INCORPORATED CP/M is a registered trademark of Digital Research. es 
67 East Evelyn Ave. « Mountain View, CA94041 « (415) 962-0230. TELEX 4940302 me 


Z80 Control 


Type Ahead 
Processor 
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Debugging Bugging You? 
Torpedo program crashes and debugging delays with 
debugging dynamite for the IBM PC ... 


UP PERISCOPE! 


First, you install the hardware. 


The hardware’s a special memory board 
that fits in a PC expansion slot. Its 16K of 
write-protected memory contains 
Periscope’s resident symbolic debugger. No 
runaway program, however berserk it may 
be, can touch this memory! 


Then you UP PERISCOPE. 


Use Periscope’s push-button break- 
out switch to interrupt a running 
program ... even when the system’s 
hung! Periscope supports Assembly, 
BASIC, C and Pascal. In addition to the 
usual debugging capabilities, some of 
Periscope’s features are: 







ecto 
po 


Stop your system in 
its tracks at any time. 


Use symbol names instead 
of addresses. 


Run a program on one monitor and 
debug on another. 


Monitor your program’s execution 
with Periscope’s comprehensive 
breakpoints. 


Debug memory-resident programs. 


Put your time to better use. 


The Periscope system is $295. It carries a 30-day money-back 
guarantee and includes the memory board, remote break-out 
switch, debugger software, 100-page manual, and quick- 
reference card. The memory board is warranted for one year. A 
demonstration disk is $5.00. 


System requirements for Periscope are an IBM PC, XT or 
Compaq, PC-DOS, 64K RAM, 1 disk drive and an 80-column 
monitor. For MasterCard and Visa orders only, call 800/421- 
5300 (ext. R96) 24 hours a day. For additional information, call 
404/256-3860 from 9 AM to 5 PM Eastern Time. 


Get your programs up and running; 


uP PERIS E! 


Data Base Decisions / 14 Bonnie Lane /Atlanta, GA | 30328 
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to do so in the future. For those inter- 
ested in pursuing the concepts further, 
he recommends Practical LCP, a Di- 
rect Approach to Structured Program- 
ming, by Albert C. Gardner (McGraw 
Hill, 1981). Mr. Grosberg has recoded 
Alex Cameron’s listing to exemplify 
his comments; this code is presented in 
Listing Two (page 98). His comments 
concerning the code itself follow: 

‘*.. 1n Mr. Cameron’s function 
‘sfopen, the call to ‘alloc’ actually oc- 
curs only once per execution, but it is 
written three times in the code [se- 
quence]. The ‘return’ occurs only once 
per execution, but is written 10 times 
[sequence]. The three main ‘if’ 
statements 


if(*mode = = ‘x’) 


are written as if they occur sequentially, 
when in fact only one of them can occur 
per execution [alternation]. The struc- 
ture of the code actually obscures the 
execution behavior of the function.” 

Mr. Grosberg doesn’t claim to have 
embodied his comments perfectly in 
Listing Two. He just created it (un- 
tested) to illustrate his remarks. I 
found the ideas worthwhile. 


Another Response to the August 
Column 

Mike Meyer writes the following con- 
cerning the August issue: 

“T just read the August *84 column. 
Applause—you struck a solid, well-bal- 
anced position. If you can continue do- 
ing as well, you'll have a great column. 

‘“‘Tet me ask a favor: Please, 
PLEASE avoid the ‘Unix/C is better/ 
worse than <fill in blank> because 
<another blank>’-type arguments. 
As you said, your column ‘exists for 
discussing C and Unix as they are, 
with the problems they have.’ Such 
discussions don’t fit into that mold and 
tend to generate more heat than light.” 

“Couple of nits: James Jones and 
Jeff Bowles are at uokvax, not ea. 
Their net address should be ucb- 
vax!mtxinu!ea!uokvax!emjej, jab}. Fi- 
nally, my last name is Meyer, not 
Meyers. If you could cease pluralizing 
me in the future, I’d appreciate it.” 

I want to apologize for this error. 
Mr. Meyer has been a regular corre- 
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ASSEMBLE 3-6 TIMES 
FASTER ON THE IBM PC 


Introducing FAST ASSEM-86™, the first Editor/Assembler for the IBM PC and PC 
compatibles. FAST ASSEM-86™ (FASM) is significantly faster and easier to use 
than the IBM Macro-Assembler (MASM). Whether you are new to assembly 
language and want to quickly write a small assembly language routine, or are an 
experienced MASM user tired of waiting months to assemble large files, FAST 
ASSEM-86 will bring the excitement back to assembly language. 































FAST ASSEM-86 IS MUCH FASTER: 


@ How fast is FASM™? The graph below shows relative assembly times for a 48K 
source file. For large files like this we blow MASM’s doors off at 3 times their 
speed. For smaller 8K files we positively vaporize them at 6 times their speed. 
FASM™ (110 sec.) 

MASM v1.0 (340 Sec. ) [IIIs 


© FAST ASSEM-86 is faster for the following reasons: (1) Written entirely in 
assembly language (unlike MASM). (2) Editor, assembler and source file always 
in memory so you can go instantly from editing to assembling and back. (3) 
Eliminates the time needed to LINK programs. Executable .COM files can h 
created directly. (Also creates .OBJ files completely compatible with the IB’ linker). 


FAST ASSEM-8&6 iS EASIER TO USE: 
FASM includes many other features to make your programming simpler. 


@ Listings are sent directly to screen or printer. Assemblies can be single stepped 
and examined without having to leave the editor. 


@ Access the built in cross reference utility from the editor. 
@ Full support of 186 and 286 (real mode) instructions. 


@ Both Microsoft and 8087 floating point formats are supported. 8087 and 287 
instructions supported directly without macros for faster assembly. 


@ Calculator mode: Do math in any radix even using symbols from the symbol table. 
@ Direct to memory assembly feature lets you test execute your code from editor. 
® Coming soon: A coordinated symbolic debugger. 


COMPATIBILITY: FASM is designed for source code compatibility with MASM and 
Supports most of its important features. 









































Dealer inquires welcome 
916-966-6247 

Box D1, 2931 Northrop Avenue 
Sacramento, CA 95825 

IBM, Microsoft trademarks of IBM Corp., Microsoft Corp. respectively. 


Introductory Price $199 
Speedware™ 
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EPROM PROGRAMMER 


_ Compatible w/all Rs 232 seria! interface port * Auto 
_ select baud rate * With or without handshaking * 
Bidirectional Xon/Xoff and CTS/DTR Supported * 

Read pin compatible ROMS * No personality 

modules * Intel, Motorola. MCS86, Hex formats * 

Split facility for 16 bit data paths * Read, program, 
formatted list commands * Interrupt riven, 

program and verify real time while 
sending data * Program single byte. 

block, or whole EPROM * Intelligent 

_ diagnostics discern bad and erasable 

_ EPROM * Verify erasure and compare 
_ commands * Busy light * Complete 

_ w/Textool zero insertion force socket 

_ and integral 120 VAC power (240 

_ VAC/SOHz available) 


$879 stand alone 
MODEL 7956 


MODEL 7956 

GANG PROGRAMMER 
Intelligent algorithm. Stand alone. 
copies eight EPROMS at a time. 4 
With RS-232 option $1099. ys pes 





DR Utility Package allows communica- 
tion with 7128, 7228, and 7956 
programmers from the CP/M com- 
mand line. Source Code is provided. 
PGX utility package allows the same 
thing, but will also allow you to specify 
a range of addresses to send to the 
programmer, Verify, set the Eprom 
type. 


$549 
MODEL 
7316 ; 





SE 


MODEL 7316 PAL PROGRAMMER 
Programs all series 20 PALS. Software 
included for compiling PAL source 
codes. 


2 
Software Available for cpm! ISIS, 


TRSDOS*>MSDOS2 


Avocet Cross Assemblers are 
available to handle 8748, 875}. 


1. TM of Digital Research Corp. ene a gps OEE 2 ene 
2. TM of Intel Corp. MSDOS computers. Order by 
3. TM of Tandy Corp. pecsse type and specify 
4. TM of Microsoft. ind of computer. 





Model DE-4 U/V Products 
hold 8, 28 pin parts. High 
quality professional construc- 
tion. 


Post Office Box 289 
Waveland, Mississippi 39576 
[601]-467-8048 


Programs all 





DEVELOPMENT HARDWARE/SOFTWARE 
| HIGH PERFORMANCE/ cost RATIO 
- iwc. (601) 467-8048 


GREAT PROGRAM ... 
TERRIBLE MANUAL ... 


How often have you seen or heard that said 


about software? 


If you have a first-class program you deserve the 
BEST documentation. At AYN SOFTWARE we can 
provide you with a top-quality manual in the 
shortest possible time. 

Whether it’s a complete service from writing, 
to design, artwork, typesetting, mechanicals, and 
printing, or any step along the way, your manual 
will be in a class with the best documentation 


available today. 


Our staff consists of writers, artists, testers, 
and even includes a CPA. Business and technical 
programs are a specialty. We pride ourselves on 
designing manuals that look expensive, but aren’t. 

We understand the time constraints of the soft- 
ware business; we’ll meet your deadlines. 

We’re proud of our work and would like to send 
you samples. For additional information, samples, 
or just some advice from the experts call: 


. . . 516-549-4090 . . . or write 








MODEL 7324 PAL PROGRAMMER 


series 20 & 24 PALS. 


Operates stand alone or via RS232. 
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SOFTWARE Inc. 


P.O. Box 895 
Melville, NY 11747 





Model 7128-L1.L2.L2A . $239.00 


Model: 7128-24 0°". $329 .00 
Rion Dae oie $ 30.00 
DR8PGX or DRSPGX . .$ 75.00 
Cross Assemblers ..... $200.00 
XASM (for MSDOS) .. $250.00 
U/V Eraser DE-4...... $ 78.00 
RS232 Cablesie: yo $ 30.00 
SYSE adapter: oo...) $174.00 
S759 adapter. 2-7. $135.00 
48 Family adapter.... $ 98.00 


MODEL 7228 
EPROM PROGRAMMER 


All features of Model 7128 plus 


Auto Select Baud . Super fast adaptive 
programming algorithms, low profile 
aluminum enclosure. Programs 2764 
in one minute! 








MODEL 7128 EPROM PROGRAMMER 


NMOS 
2508 
2516 
2532 
2564 
68766 
68764 
8755 
5133 


Programs and Read: 


NMOS CMOS EEPROM MPU'S 
2758 27€16-~< 5213 8748 
2716 27C32 5213H 8748H 
2732 C6716 X2816 8749H 
2732A 27CS4 48016 8741 
2764 12816A 8742H 
27128 8741H 
27256 8751 











spondent, which means I had ample 
opportunity to see his name and repro- 
duce it properly. (Ill get his name 
straight from now on.) He continues: 

‘“‘To add some constructive com- 
ment, I’d like to point out that relying 
on library utilities for things does not 
guarantee portability. For instance, 
many C implementations won't have 
the Unix math(3) library or the 
qsort(3) routines. Of note is that the 
current AT&T Unix distribution 
doesn’t include the dbm(3) routines 
from Unix version 7. I use those rou- 
tines to fix the ‘everything is line-ori- 
ented ASCII’ problem with Unix, and 
some of the AT&T sites that don’t have 
that library complained when they got 
copies of my software.” 

This is an interesting point that I 
had not considered. It adds more com- 
plexity to the idea of C/Unix software 
portability. What libraries can and 
cannot be assumed when writing a pro- 
gram? Is it OK to think of libraries 
such as CURSES as standard? 


Comments on the X Grammar 

I received several comments about the 
X grammar. In this column, I present 
one letter; the rest are reserved for the 
February 1985 column [DDJ No. 100]. 
John M. Gamble of Batavia, Ohio, 
writes: 

‘Your column on extensions to the 
C language was very interesting. | 
have a few comments. 

‘““(1) To keep analogy between 
functions and opers, I think that it 
should be legal to declare static opers.”” 

This sounds fine, but what is a static 





oper? Since I’m not sure what Mr. 
Gamble means, I can’t really com- 
ment. He continues: 

(2) I have trouble thinking of any 
justification for adding one more re- 
served word (loop) just to do what 
‘for(;;) does just as well. If it really 
offends your eye, couldn’t you just use 
#define to substitute for it?” 

I agree. I only mentioned “loop” be- 
cause I wanted an efficient way to 
specify an unconditional loop. This is 
fine since ‘“‘for(;;)” shouldn’t produce 
unnecessary instructions in object 
code. Mr. Gamble continues his list of 
comments as follows: 

“(3) I think that your method of de- 
claring argument lists in vec functions 
is too limited to be practical. A function 
list is not analogous to argv, which deals 
only with character strings. A function, 
after all, deals with all sorts of vari- 
ables. To get around this problem, I 
have thought of two possible solutions: 

‘“(a) Require that the first argu- 
ment be a string equivalent to printf’s 
control string. Quite frankly, I dislike 
this solution. Deciphering the control 
string would be a pain, and the code 
needed to deal with this pain would 
probably ruin C’s reputation for com- 
pact code. 

‘“(b) Declare the types of the argu- 
ment list members in the function it- 
self. This would be efficient and easy 
to modify later on. For example, say 
that you wish to have some integer 
variables, and you wish to exchange 
their values so that they are in [numer- 
ical] order. Rather than going through 
the trouble of inserting the values in an 


t an ascii file on the console */ — _ 


me character to > output af 


“FILE ‘disp: 


- itlisp = = Iopsethtanne, T = 


‘return(— 1) 


= NULL) 


_/* can't open file */ 


epee i= EGY /* print the file */ 


if(c = = reo) * text end of file */ 


— break; 
#endif 


putchar((c & 127); 


: output each character less parity */ 


fclose(disp); / oloce the file *) 


return(O); 


/* successful completion */ 





Listing Three 
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array, calling a sorting routine, and re- 
covering the values from the array, a 
vec function called sort_them( ) might 
be easier to use. The declaration might 
be as depicted in Figure 2 (page 96). 

“If you wanted to make the function 
more flexible by allowing the ordering 
to be user-specified, we could have the 
first argument be a function. Then the 
declaration would resemble Figure 3 
(page 96). 

“Of course, we are not limited to in- 
teger pointers. A vec function could 
just as easily have arguments of all 
sorts. Such an example is presented in 
Figure 4 (page 97). 

“Since the argvec array consists of 
pointers only, the addresses of the ar- 
gument list are passed in, not the val- 
ues. Therefore, register variables may 
not be used in the list. Also, since pass- 
ing addresses is the default, we can 
drop the ‘&’ before each variable [in 
the calling sequence].”’ 

I think Mr. Gamble’s ideas are valid 
and are consistent with my original in- 
tentions for an extended grammar. 
Does anyone else have further com- 
ments about vec functions? 


Conclusions 

I have wound up the year by including 
some corrections and comments about 
previous columns. The programming 
structure comments offered by Mr. 
Grosberg were particularly interesting 
to me, and I hope that others find them 
useful as well. I was pleased with Mr. 
Gamble’s suggestions concerning C 
extensions, and I look forward to addi- 
tional remarks in this area. 

My next column will appear in the 
February 1985 DDJ. This is issue No. 
100, a landmark for the journal. In this 
column, I’ll include additional reader 
feedback and suggestions as well as 
possible topics for future columns. 
Have a happy holiday season. 
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Vote for your favorite feature/article. 
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Thanks to YOU . We're Growing . 


with YOU and your Computer . 


LEO ELECTRONICS, INC. 
P.O. Box 11307 

Torrance, CA. 90510-1307 

Tel: 213/212-6133 800/421-9565 
TLX: 291 985 LEO UR 


PRICE .. QUALITY . 





We Offer . 


PERSONAL SERVICE 
64K UPGRADE 





9 Bank (IBM PC) $43.65 (150ns) 
$41.85 (200ns) 
4164 = (150ns) $4.85 ea. 
(200ns) $4.65 ea. 
8 Bank (other PC) $38.80 (150ns) 
$37.20 (200ns) 
4164 (150ns) $4.85 Ga. 
(200ns) $4.65 e4 
256K “‘Mother-Saver’’ Upgrade 
256K - (150ns) $36.00 ea 
6116P-3 — $4.40 2732 — $3.95 
2716 — $3.20 2764 — $7.00 
TMS-2716 — $4.95 27128 — $24.00 


We accept checks, Visa, Mastercard or Purchase Orders 
from qualified firms and institutions. U.S. Funds only. 
OF} | Co) aa OM OM DRM Ort ele MET -ttTe TT Caer 62% tax. 


B Shipping is UPS. Add $2.00 for ground and $5.00 for 
‘air. All major manufacturers. All parts 100% guaranteed. 


Pricing subject to change without notice. 
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Now Your 
Computer 
Can See! 


°295,00° 


A total imaging system complete 
and ready for plug-and-go opera- 
tion with your personal computer. 







The MicronEye™ offers select: 
able resolution modes of 256 x 128 
and 128 x 64 with operating speeds MicronEye™ 
up to 1D FPS. An electronic shutter “Bullet” 
is easily controlled by software or 
manual functions, and the included sample programs allow you to con- 
tinuously scan, freeze frame, frame store, frame compare, print and pro- 
duce pictures in shades of grey from the moment you begin operation. 

Only the MicronEye™ uses the revolutionary IS32 OpticRAM™ image 
sensor for automatic solid state image digitizing, with capability for grey- 
tone imaging through multiple scans. And with these features, the 
MicronEye™ is perfectly suited for graphics input, robotics, text and 
pattern recognition, security, digitizing, automated process control and 
many other applications. 

The MicronEye™ is available with immediate delivery for these com- 
puters: Apple Il, IBM PC, Commodore 64 and the TRS-80CC (trademarks of 


Apple Computer Inc., International Business Ma- 


chines, Commodore Corp., and Tandy Corp. 
TECHNOLOGY, INC. 


respectively). 
Phone for MicronEye™ information 
VISION SYSTEMS 
2805 East Columbia Road 


on the Macintosh, TI PC and RS232 
(trademarks of Apple Computer Inc. and Texas In- 

Boise, Idaho 83706 
(208) 383-4106 


struments respectively.) 
TWX 910-970-5973 


*(Add $10.00 for shipping and handling [Federal 
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Express Standard Air]; residents of the following 
states must add sales tax: AK, AZ, CA, CO, CT, FL, 
GA, IA, ID, IL, IN, LA, MA, MD, ME, MI, MN, NC, NE, 
NJ, NY, OH, PA, SC, TN, TX, UT, VA, VT, WA, WL) 


















PROMPT DELIVERY!! 


SAME DAY SHIPPING (USUALLY) 


IC. 
















DYNAMIC RAM 
256K 256Kx1 120 ns $24.47 
256K 256Kx1 150 ns $22.47 
64K 64Kx1 120 ns 3.87 
64K 64Kx1 150 ns 3.67 
64K 64Kx1 200 ns 3.56 
EPROM 
27256 32kx8 300 ns $45.97 
27128 16kKx8 300ns_ 13.67 
27C64 8Kx8 200 ns 22.50 
2/764 8Kx8 250 ns 6.50 
2732 4Kx8 250 ns 6.37 
2716 2Kx8 450 ns 3.50 
STATIC RAM 
6264P 8Kx8 150ns $23.67 
6116P 2Kx8 150 ns 4.37 


Open 6% days: We can ship via Fed-Ex on Sat. 


MasterCard/VISA or UPS CASH COD 
Factory New, Prime Parts 


MICROPROCESSORS UNLIMITED 
24,000 South Peoria Ave. (91 8) 267-4961 


BEGGS, OK. 74421 


Prices shown above are for November 3, 1984 
Please call for current prices & volume discount. Prices subject to change. Please expect 
higher prices on some parts due to world wide shortages. Shipping and insurance extra. 
Cash discount prices shown. Small orders received by 6 PMCST can usually be delivered to 
you by the next morning, via Federal Express Standard Air @ $6.75! 
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OPT-TECH SORT™ 





SORT/MERGE program for IBM-PC & XT 


Now also sorts dBASE II files! 


e Written in assembly language for high performance 
Example: 4,000 records of 128 bytes sorted to give 
key & pointer file in 30 seconds. COMPARE! 


¢ Sort ascending or descending on up to nine fields 

e Ten input files may be sorted or merged at one time 

e Handles variable and fixed length records 

e Supports all common data types 

e Filesize limited only by your disk space 

e Dynamically allocates memory and work files 

¢ Output file can be full records, keys or pointers 

e Can be run from keyboard or as a batch command 

e Can be called as a subroutine to many languages 

e Easy to use, includes on-line help feature 

e Full documentation — sized like your PC manuals 

e $99 —VISA, M/C, Check, Money Order, COD, or PO 
Quantity discounts and OEM licensing available 


To order or to receive additional information 
write or call: 


OPT-TECH DATA PROCESSING 
P.O. Box 2167 Humble, Texas 77347 
(713) 454-7428 
Requires DOS, 64K and One Disk Drive 
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Put Dr. Dobb’s Under the Christmas Tree! 
Treat your friend (or yourself!) to Dr. Dobb’s Journal 





Vol. 1 1976 


The material brought together in this volume chronicles the development in 
1976 of Tiny BASIC as an alternative to the “finger blistering,” front-panel, 
machine-language programming which was then the only way to do things. 
This is always pertinent for bit crunching and byte saving, language design 
theory, home-brew computer construction. and the technical history of 
personal computing. 

Topics include: Tiny BASIC, the (very) first word on CPIM, Speech Synthesis, 
Floating Point Routines, Timer Routines, Building an IMSAI, and more. 


Vol. 2 1977 


1977 found DD4J still on the forefront. These issues offer refinements of Tiny 
BASIC, plus then state-of-the-art utilities, the advent of PILOT for microcompu- 
ters and a great deal of material centering around the Intel 8080, including a 
complete operating system. Products just becoming available for reviews 
were the H-8, KIM-1, MITS BASIC, Poly Basic, and NIBL. 

Articles are about Lawrence Livermore Lab’s BASIC, Alpha-Micro, String 
Handling, Cyphers, High Speed Interaction, I/O, Tiny Pilot & Turtle Graphics, 
many utilities, and even more. 


Vol. 3 1978 


The microcomputer industry entered its adolescence in 1978. This volume 
brings together the issues which began dealing with the 6502, with mass- 
market machines and languages to match. The authors began speaking more 
in terms of technique, rather than of specific implementations; because of this, 
they were able to continue laying the groundwork industry would follow. 
These articles relate very closely to what is generally available today. 
Languages covered in depth were SAM76, Pilot, Pascal, and Lisp, in addition to 
RAM Testers, S-100 Bus Standard Proposal, Disassemblers, Editors, and much, 
much more. 


Vol. 4 1979 


This volume heralds a wider interest in telecommunications, in algorithms, 
and in faster, more powerful utilities and languages. Innovation is still present 
in every page, and more attention is paid to the best ways to use the proces- 
sors which have proven longevity—primarily the 8080/280, 6502, and 6800. 
The subject matter is invaluable both as a learning tool and as a frequent 
source of reference. 

Main subjects include: Programming Problems/Solutions, Pascal, Information 
Network Proposal, Floating Point Arithmetic, 8-bit to 16-bit Conversion, 
Pseudo-random Sequences, and Interfacing a Micro to a Mainframe—more 
than ever! 


Vol. 5 1980 


All the ground-breaking issues from 1980 in one volume! Systems software 
reached a new level with the advent of CP/M, chronicled herein by Gary 
Kildall and others (DDJ's all-CP/M issue sold out within weeks of publication). 
Software portability became a topic of greater import, and DDJ published Ron 
Cain’s immediately famous Small-C compiler—reprinted here in full! 
Contents include: The Evolution of CP/M, a CP/M-Flavored C Inerpreter, Ron 
Cain’s C Compiler for the 8080, Further with Tiny BASIC, a Syntax-Oriented 
Compiler Writing Language, CP/M to UCSD Pascal File Conversion, Run-time 
Library for the Small-C Compiler and, as always, even rnore! 


Vol. 6 1981 


1981 saw our first all-FORTH issue (now sold out}, along with continuing cover- 
age of CP/M, small-C, telecommunications, and new lanquages. Dave Cortesi 
opened “Dr. Dobb's Clinic” in 1981, beginning one of the magazine's most 
popular features. 

Highlights: information on PCNET, the Conference Tree, and The Electric Phone 
Book, writing your own compiler, a systems programming language, and Tiny 
BASIC for the 6809. 
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YE Ss! [] Please send me the following Volumes of Dr. Dobb’s Journal. 























This offer expires February 28, 1985 























= [} ALL 7 for ONLY $165, a savings of over 15%! Vol. | x .$26.75.= 
Vol. 2 x $27.75 = 
Payment must accompany your order. Vol. 3 x $27.75 = 
Please charge my: O Visa [] MasterCard (] American Express Vol. 4 x $27.79 = ______— 
lenclose (J Check/money order Vol. 5 x $27.75 = ______ 
Vol. 6 Ma Sd oh Ba cee ee 
Card # Expiration Date Vol. 7 Me SSO Does a ea 
All 7 KGS OO ee 
Signature 
Sub-total $ 
Name Address Postage & Handling 
City State ce Must be included with order. 


Mail to: Dr. Dobb’s Journal, 2464 Embarcadero Way, Palo Alto, CA 94303 


Allow 6-9 weeks for delivery. 


Please add $1.25 per book in U.S. 
($3.25 each surface mail 

outside U.S. Foreign Airmail 

rates available on request.] 
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P. 0. Box 280298 Dallas, Texas 75228 









B. 6. MICRO 


Big Computer Mfg. Makes $900,000 Goof!! 


COMPUTER/DISK DRIVE 
SWITCHING POWER SUPPLY 


ORIGINALLY DESIGNED TO RUN A Z-80 
BASED SINGLE BOARD COMPUTER 
WITH TWO 5-1/4 IN. DISK DRIVES AND 
CRT MONITOR. 













ADD $1.50 PER UNIT FOR UPS 









SPECS: + 5VDC 5 AMPS MAX 
#1 + 12 VDC 2.8 AMPS MAX 

#2 + 12 VDC 2.0 AMPS MAX 

-12 VDC .5 AMPS MAX 








INPUT: 115 or 230 VAC 60Hz 





SMALL SIZE: 6-1/8 x 7-3/8 In. 
HIGH EFFICIENCY SWITCHER MFG. 
BY CAL. DC IN USA! 


The poor Purchasing Agent bought about 10 times as many of these DC 
Switchers as his company would ever use! We were told that even in 
10,000 piece lots they paid over $72 each for these multi-output 
switchers. When this large computer manufacturer discontinued their 
Z-80 Computer, guess what the Big Boss found in the back warehouse; 
several truckloads of unused $72.00 power supplies. Fortunately we 
heard about the deal and made the surplus buy of the decade. Even 
though we bought a huge quantity, please order early to avoid 
disappointment. Please do not confuse these high quality American 
made power supplies with the cheap import units sold by others. 





TERMS: Orders over $50 add 85¢ insurance. No COD. Tex. Res. Add 6% Sales Tax. Subject to prior sale. Foreign orders: US funds only. We cannot ship 
to Mexico. Foreign countries other than Canada add $6 per board shipping. 
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SOFTWARE REVIEWS 





NCI COHERENT 

Company: Network Consulting 
Inc., Suite 110, 3700 Gilmore 
Way, Burnaby, B.C. Canada 
V5G4M1 

Computer: IBM PC and IBM XT 

Price: $695 

Circle Reader Service No. 127 

Reviewed by A. Gomez 


COHERENT was developed by the 
Mark Williams Co. as a Unix look- 
alike that did not have to pay royalty 
fees to AT&T. NCI has modified CO- 
HERENT with a number of real-time 
enhancements to enable efficient mul- 
tiuser operation with small machines. 
The kernel is ROMable and may be em- 
bedded in peripheral modules and soft- 
ware for communications packages. 
The utilities for the most part were re- 
written in assembly language for speed 
of execution. Finally, specific hardware 
is supported that allows expedient pro- 
cessing in a Unix style environment. 


Features 

The features of NCI COHERENT fall 

into two parts: hardware and software 

support. Hardware support is the sup- 
port of a specific item of hardware that 
allows flexibility of configuration or 
enhances the performance of the sys- 
tem. Software features are those that 
provide ease of programming or sys- 
tem use. By this definition, a hardware 
feature may be a piece of software 

(e.g., a device driver). 

The hardware features of NCI CO- 

HERENT are: 

e Choice of hard disk support: NCI 
COHERENT provides device drivers 
for the XT, CORVUS, CORONA, 
DAVONG, TECMAR, GENIE, EA- 
GLE, INTERPHASE SMD, MAY- 
NARD SASI interface, and COLUM- 
BIA disk controllers and drives. Note 
that this feature allows NCI COHER- 
ENT to operate on compatibles as 
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well as the PC itself. 

Ziatech IEEE-488 interface: The 488 
interface is important in control 
applications. 

Interactive Data Systems 1600 BPI 
tape drive interface: This device driv- 
er allows the use of 9-track tape with 
NCI COHERENT. 

Tall Tree Systems JRAM card: This 
card is frequently used as a RAM 
disk because of its ability to window 
itself in an already RAM-filled PC. it 
has 512K of RAM on each card and 
can increase performance of swap- 
ping systems by being part of the file 
system. 

Persyst 4-line serial port card with 
onboard 8088: This allows the main 
processor to be off-loaded and per- 
mits the suitable execution of real- 
time applications in a multiuser 
environment. 

Control Systems Hostess 8-line seri- 
al port card: This card is necessary to 
provide the 1l-user capacity that is 
claimed by NCI. The card supports 
XON/XOFF and variable size words 
(5 to 8 bits) in either interrupt or 
polled mode. 

Hayes autodialer (or any other auto- 


Benchmark | ‘Compile Time 


(sec) 


19 
18 


System call 
Function call 
Sieve 

Disk write 

Disk read 

Shell 

Loop 


~ Ww 
co ro) 
fon) 


33:0 


—_ 
o 
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Multiprocess 
benchmark 
Multi.sh 


(2) 
21.3 


(1) 
15.1 
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Table 1 





dialer with programming effort): 
This provides support for the “cu” 
program. 
¢ Support of the AST real-time clock 
via the ‘“‘clock”” command. 
¢ Support of three .parallel line 
printers. 
The software features of NCI CO- 
HERENT are: 
¢ Kernel parameters: NCI COHER- 
ENT provides the ability to change 
the kernel parameters via commands 
(e.g., partitioning of RAM disk). 
TERMCAP: This package will allow 
programs that are screen based to be 
terminal independent. It is widely 
used in the Unix community. 
165 Unix V7 commands: These com- 
mands are rewritten in assembly lan- 
guage for speed. 
¢ Lex and Yacc: A lexical analyzer and 
compiler compiler, commonly found 
and used on Unix systems, are of 
great value to developers who need to 
create parsers and lexical analyzers. 
¢ RCS: This is a source code control 
system. 
Unix SYSTEM V memory routines: 
These routines are supported in the 
kernel and include memccpy, 







Execution Time (sec) 


Real User System 
274 O11 22.0 
295 2.38 26.4 
0.5 0.3 0.1 

8.5 8.1 0.2 
713 0.1 6.3 
160 01 7.0 
13.0 14 5.3 
266 -264 C0} 










# Processes 
(3) (4) 
29.1 36.6 
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memchr, memcmp, memcpy, and 
memset. 
Prolog interpreter: The prolog inter- 
preter is frequently used in artificial 
intelligence work and control 
applications. 
An IEEE floating point math pack- 
age that is accessible by the Unix 
math library routines. 
A screen editor (“‘see”’): This is not 
the VI or EMACS, with which all of 
us are familiar, but a screen editor. 
License fees: The single-user price is 
the multiuser price; no additional 
fees are necessary. Furthermore, 
runtime only versions are available 
for applications with embedded ker- 
nels and offboard processors. This al- 
lows software developers to use the 
facilities of the NCI COHERENT 
kernel in their product without hav- 
ing the customer pay the full price of 
NCI COHERENT. 
¢ Coming soon is a MSDOS bridge that 
allows a MSDOS program to run un- 
der NCI COHERENT. 
Documentation consists of a refer- 
ence manual (sections 1—8 of the 
Unix manual), a tutorial manual (ed, 
m4, lex, rcs, etc.), and the book Using 
the UNIX System by Richard Gauth- 
ier. The documentation was complete 
and organized in a manner consistent 
with other Unix systems. 


Unix Compatibility 

NCI COHERENT was designed to be 
compatible with Unix V7, and it looks 
like NCI has achieved its goals. All the 
system calls are identical, the libraries 
are identical, and only minor functions 
or user programs are different. 

To check its compatibility, I moved 
various applications between a V7 
Unix, the NCI COHERENT, and a 
SYSTEM V Unix. Without exception, 
all worked without error. Of course, 
these programs did not use the addi- 
tional features of SYSTEM V, but then 
I was checking for V7 compatibility. 


Benchmarks 

Nothing is more controversial than 
benchmarks in product marketing. It is 
really hard to choose a set of programs 
that presents a fair comparison of dif- 
ferent products. The benchmarks that 
I used in measuring NCI COHERENT 
were those found in the July 1984 issue 
of Byte magazine in an article named 


Dr. Dobb’s Journal, December 1984 


‘Benchmarking UNIX Systems” by 
David F. Hinnant. These benchmarks 
appear to be fair and, more important- 
ly, to provide a set of measurements 
upon which to grade the performance 
of NCI COHERENT. In that article, 
Mr. Hinnant provides timings for nine 
benchmarks in 15 different systems. 
Table | (on page 106) shows the mea- 
surements of NCI COHERENT for the 
same benchmarks. 

By comparing NCI COHERENT to 
other Unix systems on the PC, we see 
no improvement in the single-user en- 
vironment. However, as the number of 
active processes increases, the degra- 
dation of NCI COHERENT is less than 
other Unix systems. 


Closing Notes 

In general, I was impressed by NCI 
COHERENT. NCI has placed its em- 
phasis on the performance of a system 
with more processes than that found in 
a single-user environment. Although I 
did not test the multiuser capability of 
the product, I do not doubt that it ex- 
ists because of the orientation of the 
kernel. The price is reasonable, consid- 
ering other offerings for the IBM PC, 
and the company looks like it’s heading 
toward full compatibility with Unix 
SYSTEM V, which allows a future for 
its products and support. 


Turbo Pascal Version 2.0 

Company: Borland International, 
4113 Scotts Valley Drive, 
Scotts Valley, CA 95066, 1- 
800-227-2400 ext.968 out- 
side California, 1-800-772- 
2666 ext.968 in California 

Computer: MSDOS, PCDOS 

Price: $49.95 
$89.95 with 8087 support 

Circle Reader Service No. 129 

Reviewed by Karl R. Kachigan 


Well, it just had to happen. Friends 
were talking about it, the computer 
shows featured it, and just about every 
magazine beamed about its significant 


‘performance for the price. Just what 


kind of decent Pascal could this be for 
$49.95? Originally, because it didn’t 
support graphics on my IBM PC, | ig- 
nored it, continuing to use my UCSD p- 
System Pascal with its Turtlegraphics 
and other goodies. Then version 2.0 
was announced—it supported graph- 


ics, color, sound, windows, overlays, 
and was still only $49.95. I nibbled. I 
telephoned in my order, and about a 
week later I became a believer. For the 
price and its features, Turbo Pascal 
compares quite well with my UCSD p- 
System Pascal. 

Before you wonder how I was con- 
verted, let me say that Turbo Pascal is 
truly a good solution for both the nov- 
ice and the experienced programmer. 
When Turbo Pascal is properly in- 
stalled, and that isn’t a difficult task, 
you have a nicely integrated program- 
ming system. The editor/compiler lets 
you compose a program, compile it, 
and either run it or return to the editor 
to correct errors flagged by the system, 
all without using the disk. 

To those unfamiliar with the UCSD 
p-System, its editor, filer, and compiler 
are integrated but usually not simulta- 
neously resident in memory (unless 
you configure a RAM disk that can 
simulate this). The UCSD Pascal com- 
piler/ecitor obviously was the model 
for Turbo Pascal. Both indicate syntax 
errors with descriptive messages and 
will point to them if you return to the 
editor. Turbo Pascal just seems faster 
and slicker at it; plus, for those of us 
using the IBM PC, it runs under 
PCDOS. Only recently has the UCSD 
p-System been capable of doing this. 
However, the UCSD p-System does 
provide more capability, machine con- 
trol, and transportability—but at a 
much higher cost. 

This review should give you a better 
feel for the version 2.0 enhancements, 
especially on the IBM PC. I will build 
upon David Clark’s review of Version 
1.0 in the June 1984 issue of DDJ. 
Please reread this article if some of my 
points seem unclear. Because many of 
the fancy additions (the manual calls 
them “IBM PC goodies’’) are specific to 
the IBM PC and its compatibles, I will 
try to point out what features are appli- 
cable to all machines and which are 
IBM specific. Table 2 (page 110) lists 


all of the enhancements in version 2.0. 


















What Is Turbo Pascal? 

Turbo Pascal is distributed as either 
one or two disks (the second is for 
MSDOS/PCDOS 8087 support), two 
manuals, several programs including 
sample programs, and an update file 
giving last minute information. Turbo 
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Pascal itself is composed of either two 
or three files: compiler/editor (TUR- 
BO.COM, TURBO.CMD, TURBO- 
87.COM, or TURBO-87.CMD), error 
message data file (TURBO.MSG), and 
for CP/M-80 only an overlay file 
(TURBO.OVR). A terminal installa- 
tion program, provided to customize 
the Turbo Pascal screen control and 
editor features, includes the program 
itself (TINST.COM or TINST.CMD), a 
message data file (TINST.MSG), and a 
terminal data file (TINST.DTA, not on 
the IBM PC version). Provided on all 
versions is a program lister (TLIST- 
COM or TLIST.CMD) and a sample 
spreadsheet program called MicroCalc 
(supplied in source code form). Includ- 
ed with the MSDOS/PCDOS versions 
are information files on using MSDOS 
function calls, external assembly lan- 
guage routines, and interrupts, each 
with comments and a sample program 
listing. The IBM PC version adds sam- 





ple programs on color, graphics, sound, 
and windows—all in source code 
format. 

The manuals, an updated version 1.0 
manual and a short version 2.0 supple- 
ment, attempt to cover all versions of 
Turbo Pascal (CP/M-80, MSDOS, 
PCDOS, and CP/M-86). They are type- 
set, seemingly well structured, and 
indexed. 

Standard Turbo Pascal uses real 
numbers with a range of 1.0E—38 to 
1.0E+38 and 11 significant digits. 
With the 8087 support, these expand 
to 4.19E-307 to 1.67E+308 and 16 
significant digits. As for RAM require- 
ments, version 2.0 for MSDOS takes 
35K and for PCDOS 36K, compared 
with 33K for the old version 1.0 16-bit 
implementations. 


Editor Enhancements 
I’ve mentioned that the built-in editor 
is a nice feature. A full screen editor, it 


dBASE 


Dont let QnyDO 





do a KUWUEET On YOU. 


CCP/M, CP/M, and MP/M are trademar's of Digital Research. TurboDOS, MmmOST, MUSE, NSTAR, MS-DOS, PC-DOS, PC Net, DNA, EtherShare, and NetWare are trademarks of System 2000, 
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requires specific information on your 
terminal’s control sequences and edit- 
ing commands/keystrokes. Here is 
where the terminal installation pro- 
gram is helpful. It has two modes: se- 
lect (or define) the terminal used and 
define the edit command keystrokes. 
For the non-IBM versions, a large se- 
lection of the most popular terminals 
are listed. If you are using one on the 
list, just select it. If yours is not listed, 
you can add your terminal to the list by 
entering the appropriate information, 
such as the cursor acidressing, screen 
clear, insert/delete line, and enhance 
on/off control sequences. In either 
case, Turbo Pascal is now installed for 
the selected terminal. 

I installed the MSDOS version on my 
HP-150 by adding my terminal to the 
list and found the installation program 
quite accommodating. It was gratify- 
ing to see a program that could adapt 
to my HP-150’s lengthy cursor ad- 


V7 


You waited years 

for an advanced version of dBASE Il. 
Without the bugs. 

Without the limitations. 


It never came. 


Instead, you got dBASE: Ill. 
A half solution. 

A bandage instead of é& cure, 
so to speak. 


Here’s what we mean. 


As an applications programmer, 
you're now supposed to use 

dBASE III to write a program on 
single-user 16-bit PCs...use dBASE Il 
to write the same application for 
8-bit machines and use heaven 
knows what to handle the multi-user 
or networked situations. 

Contrast that with Q-PRO 4...the 
true 4th generation applications 
development language for micro- 
computers. 
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dressing sequence (typically nine char- 
acters with ASCII row and column ad- 
dressing). The IBM PC version lets you 
select from six display modes: default 
monitor, monochrome monitor, mono 
or color 40 columns, and mono or color 
80 columns. 

As for the editor, 45 commands are 
listed, almost all of them standard 
WordStar features. The version 2.0 
manual claims to have added seven 
new commands, but they were also list- 
ed in the version 1.0 manual. (Appar- 
ently these were documented before 
they were actually implemented.) I felt 
right at home using the familiar Word- 
Star control sequences again. This is 
truly a nice touch, especially having 
the same block move/copy/delete and 
find/search/replace capabilities. Not 
only does the IBM PC version use the 
WordStar commands, but version 2.0 
also hooks up all the IBM PC keys, such 
as insert/delete, page up/down, cursor 





Q-PRO 4 handles all the micros ... 

local area networks (with record and 
file locking), multi-user, single-user, 
8-bit, 16-bit, even the new IBM AT. 


The user-friendly applications you 
write with Q-PRO 4 are fully 
transportable. They run faster. 
And you can protect them with 
our author's lock up package. 


Q-PRO 4 is the professional 
developer’s package with no 
limitations. It runs under PC-DOS. 
MS-DOS, CCP/M, PC Net, NetWare, 
EtherShare, DNA, CP/M, MP/M. 
TurboDOS, MmmOST, MUSE, 
and NSTAR. 

And, just in case you don’t read 
reviews or attend seminars, 
Q-PRO 4 is the one that the com- 
puter experts evaluated alongside 
GBASE || and showed how Q-PRO 4 
blows dBASE Il away. 


pad, home/end, and many more. 

For the 8087 version, please note 
that you must temporarily rename the 
TURBO-87 file to TURBO if you want 
the TINST program to install your ter- 
minal selection with the right runtime 
program. After running TINST, you 
can change the updated TURBO file 
back to “TURBO-87” to distinguish it 
from the standard TURBO. 


Speed 

Okay, here’s where Turbo Pascal 
shines, compared with the other Pas- 
cals on the market. I wondered how 
Borland could be so brash in their ad- 
vertisements claiming Turbo Pascal 
compiled in seconds while others com- 
piled in minutes. Quite simply, you 
edit a file by bringing it into RAM then 
selecting the memory compilation 
mode, after which Turbo Pascal com- 
piles from RAM just as if you were us- 
ing a RAM disk—at blazing speed with 


Q-PRO 4 | dBASE II| dBASE III 








DATA BASE 

‘#Fields : Unlimited 128 

Multi key ISAM Needs 
sorting 

LOCAL AREA 

NETWORKS 

Record lock No 

PORTABILITY 

16-bit > 8-bit Yes No 

MISCELLANEOUS 

Formatted data entry Full | Limited | Limited 





Report generator Full Limited | Limited 
Memory variables Unlimited| 64 | 256 
Programmable 21 0 





function keys 


no disk accesses. 

I had configured my UCSD p-Sys- 
tem on my IBM PC to do this, and it 
sure makes Pascal a fun language to 
use: I don’t even mind the iterations of 
edit, compile, find the missing semico- 
lon, re-edit, and so on. Turbo Pascal 
makes this RAM disk-like feature 
transparent to the user by defaulting to 
it. Of course, you can also compile to a 
disk file for execution outside the Tur- 
bo Pascal environment (i.e. stand- 
alone applications or programs). 

A simple test of compilation speed 
was to compile one of the sample IBM 
programs, ART.PAS, a graphics demo. 
With my stopwatch in hand, I deter- 
mined that the 151-line program com- 
piled in 3 seconds! Longer programs 
such as the MicroCalc demo also com- 
piled in an amazingly short time. The 
painful part of Pascal—compilation 
and syntax correction—has been re- 


' moved. Even novices will appreciate 


-PRO 








One last word. 


If you still write business applica- 
tions with an old second genera- 
tion language like BASIC, now’s 
the time to stop ripping yourself 
off. Q-PRO 4 is the productivity 
tool that lets you write much better 
applications in one tenth the time. 
No exaggeration. 


Single-user—$595; Multi-user—$795 
Demo package available. 
Author’s lock up available. 


And don’t dump your dBASE files. 
A Q-PRO 4 utility will convert them. 


Order Q-PRO 4 now. 


136 Granite Hill Court 
Langhorne, PA 19047 
(215) 968-5966 Telex 291-765 


Quic-n-@asi products inc. 





TeleVideo Systems, OSM, Molecular, Microsoft, IBM, Orchid Technology, Network Development Corp.. 3 COM and Novell respectively. dBASE Il and dBASEIII are trademarks of Aston.Tate. 
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that their learning time can be spent 
more on the language than on compila- 
tion syntax checking. 

As for execution speed I unfortunate- 
ly couldn’t locate an 8087 to check Tur- 
bo Pascal’s true speed, but I can com- 
pare common benchmarks running on 
my 4.77 MHz IBM PC and my 8 MHz 
HP-150. Using the DDJ Savage float- 
ing-point benchmark that first ap- 
peared in November 1983, I produced 
some new entries for Ray Duncan’s 
floating-point benchmark table that ap- 
peared in DDJ’s August 1984 issue. 
This benchmark really tests the round- 
off errors and significant digits of a lan- 
guage, plus its math speed. Like Turbo 


Pascal version 1.0, version 2.0 still GraphColorMode; | 
doesn’t include an arctangent function, GraphMode; XX 
so I had to do it in math. HiRes; ne 
As you can see in Table 3 (below), GrgphBockgroindiCalor Integer); py 
Turbo Pascal version 2.0 hasn’t really Palette(Color:Integer); XX 
increased its speed on the IBM PC from HiResColor(Color:Integer); XX 


version 1.0; the HP-150 excells primari- 
ly due to its 8 MHz CPU. While Turbo 
Pascal doesn’t show blazing execution 
speed, it is very accurate in its math. 


The Reference Manuals 

My only complaint with the manual is 
that, in trying to cover the CP/M-80, 
PCDOS/MSDOS, and CP/M-86 varia- 
tions in one manual, the summary ta- 
bles occasionally were incomplete for 
the 16-bit versions: the tables represent- 
ed the CP/M-80 implementation cor- 
rectly but failed to really indicate the 
additional procedures and functions of 
the 16-bit implementations. The man- 
ual is divided into sections: general in- 
formation, CP/M-80 specific, MSDOS/ 
PCDOS specific, CP/M-86 specific, and 
summary tables. In the 16-bit sections 
covering the MSDOS/PCDOS and 
CP/M-86 function calls, no syntax defi- 
nitions were given at all. I really had to 
study the documentation files on the 
distribution disk to get the necessary in- 


version 2.0 additions are IBM PC spe- 
cific, plus be more accurate. Both of 
the window procedures and the draw 
procedure were improperly listed. No 


Enhancement 
Reserved word _ 
overlay 
procedure | 
Dispose(var P:Pointer); 
FreeMem(var P:Pointer, I:Integer); 


TextMode(Color:Integer); 


TextBackground(Color:Integer); 
TextColor(Color:Integer); 


Plot(X, Y,Color: Integer); 


Draw(X1,Y1,X2,Y2,Color:Integer); 


Window(X1,Y1,X2,Y2:Integer); 


GraphWindow(X1,Y 1,X2,Y 2:Integer); xx 


Sound(I:Integer); : 
NoSound; — 


function CS 
MaxAvail: Integer 
WhereX: Integer; — 
beet mp ot : 


pre-defined constants 
4 for text mode een 
16 for color selection 
1 for inka) 


So Table 7 
“Turbo Pascal Version 2.0 Enhancements 


mention is made of any differences be- 
tween the CP/M-80 and 16-bit imple- 
mentations of overlays and the dispose 
function, so I trust both work similarly. 


IBM PC Orily 





XX 
XX 
XX 


XX 


XX 
XX 


XX 


XX 
XX 


XX 
XX 








_ Time (sec) Error_ 





Turbo Pascal 2.0 ?? 

Turbo Pascal 2.0 82> ~~ 
HP-150(8088) 8 Turbo Pascal 2.0 396 4 4 
IBM PC(8088)t 4.77  TurboPascal 1.0 B44 
* Same results with PCDOS and MSDOS versions of Turbo Pascal 
+ As tested by Jeff Furgal 


IBMPC(8088) 4.77 
IBMPC(8088)* 4.77 


formation. This may have been due to 
an initial uncertainty in their imple- 
mentation, but this is the second edition 
of the version 1.0 manual. I hope that 
Borland will update this manual soon to 
clean up its errors. 

As for the version 2.0 manual, it is 
short and simple. The descriptions of 
the overlays, graphics, color, sound, 
and 8087 enhancements are adequate. 
Once again, the summary table could 
be more helpful in indicating which 
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Table 3 
Turbo Pascal Benchmarks 
for June 1 984 DDJ 16-Bit Toolbox 
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PROLOG-86" 


implements the ‘‘standard’’ features described in Clocksin and Mellish, has 
tutorials and sample programs to learn from that include: 


e an Expert System 
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Compiler Directives 

Nothing new here except that the X 
directive (array index optimization) is 
CP/M-80 specific and not used in the 
16-bit versions. Also, the I directive 
(I/O error checking on/off) uses the 
standard Pascal function IoResult, not 
IoError. Both of these are corrections 
to David Clark’s version 1.0 review. 


New Enchancements 

Here’s a simple overview of what ver- 
sion 2.0 adds. For all versions: 

(1) Overlay system (with code swap- 
ping to write programs larger than the 
memory available for program code) 
(2) Dynamic heap (with a real dispose 
function to supplement the more re- 
strictive mark and release procedures 
of version 1.0) 

(3) Additional editor commands 

For IBM PC and compatibles only: 

(4) Colors 

(5) Graphics 

(6) Windows (graphics and text) 

(7) Sound 

For 16-bit versions: 

(8) Optional 8087 support 


Overlays 

How many times have you composed a 
program that ended up being too large 
to compile? Many large application 
programs are like this. Programmers 
usually resort to breaking the program 
into smaller chunks that are indepen- 
dent in function to the others. If you 
think this sounds like the definition of 
a procedure or function, you’re right, 
except that it is on a larger scale: 
groups of procedures and functions are 
the chunks. Some familiar terms and 
techniques to achieve this are overlays, 
chaining, separate compilation, seg- 
ments, units, external modules, and so 
on. Let’s take a quick look at the most 
popular techniques to see how Turbo 
Pascal and its overlays fit in. 

Chaining is best exemplified by Mi- 
crosoft BASIC, whether it is on CP/M, 
MSDOS, or the IBM PC. Fundamental- 
ly, every program has a runtime li- 
brary of built-in functions plus vari- 
able/data space. One program can 
‘“‘“chain”’ to another (i.e., call the other 
program and relinquish control) with 
little difference in the programs be- 
yond executing a chain statement. 
Chained programs also typically like 
to pass information to one another 
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without using a disk file—via common 
variables. Common variables mean 
that the intepreter or compiler sets 
aside a specific amount of variable 
space, protecting it from being de- 
stroyed in the chaining process. If the 
chained programs have equivalent 
common-variable definition state- 
ments, these variables aren’t garbage 
or initialized but retain their values for 
use by the new program. Key advan- 
tages are in passing data; also, with 
compiled programs, the runtime li- 
brary need not be loaded again. 

Separate compilation and modules 
let you write parts of the program sepa- 
rately, each with different variables, 
types, procedures, and functions. After 
all the separate modules are compiled, a 
main program (sometimes called a shell 
program) calls each module as it needs 
it. This may entail loading all the mod- 
ules in memory at once or doing memo- 
ry management and swapping in and 
out of memory only the modules that 
are most recently used. Both MS-Pascal 
and UCSD p-System Pascal implement 
variations of this. In fact, the UCSD p- 
System itself is an excellent example of 
separate compilation; many of its users 
quickly notice the disk swapping of the 
numerous parts of its system in and out 
of memory as needed. Key advantages 
are that you can write and compile 
many chunks of a program indepen- 
dently of the others to compose a rather 
large application. 

Overlays are similar to both chain- 
ing and separate compilation. As im- 
plemented in Turbo Pascal, you may 
compose a program with as many over- 
lay groups in the source code as you 
want and compile it all at one time. An 
overlay group is a sequential list of 
procedures and functions that can be 
called independently of the others in 
the list. Each overlay group sets aside 
an amount of memory equal to the 
largest procedure or function in the 
group, then swaps into this space the 
procedure or function you call. To use 
one or more overlay groups in the pro- 
gram, you effectively define which 
routines don’t call each other, then 
group them together in their own over- 
lay. Key advantages are code swapping 
for minimal program memory. 

In Turbo Pascal, you define an over- 
lay group with a sequential list of rou- 
tines using “overlay” preceding the 


function or procedure declaration. 
Note that an overlay group ends when 
a procedure or function definition 
without the overlay designation is en- 
countered. Hence, you can set up sev- 
eral overlay groups, separating each 
group with a non-overlay routine— 
even a dummy procedure of begin/end 
will do it. 

Listing One (page 117) shows a pro- 
gram composed of two overlay groups, 
each with two procedures. Note that a 
disk access is performed with each call 
to a new procedure in ari overlay group. 
As Turbo Pascal compiles your pro- 
gram, each overlay group is compiled to 
disk under the name of your program 
with a file type of .000, .001, .002, and 
so on. This means 1000 overlay groups 
are possible for a single program! The 
number of routines per overlay group 
seems to be unlimited. To actually com- 
pile a program with overlays, you must 
select compilation to the disk; Turbo 
Pascal can’t handle it in its own memo- 
ry. Likewise, to run the compiled pro- 
gram, you must exit Turbo Pascal and 
execute the program from DOS—defi- 
nitely an inconvenience. 

The advantages of overlays in Turbo 
Pascal are in saving program and data 
space, especially since overlays can be 
nested. The disadvantages are that you 
can’t compile to memory, the program 
and overlay files must reside on disk, 
you can’t execute a program while in 
Turbo Pascal, extra time is needed for 
the disk I/O for overlay retrieval, ex- 
tra code is generated for overlay man- 
agement, and the runtime debugger 
has problems inside the overlay 
groups. 

I have a greater appreciation of the 
UCSD p- System separate compilation 
capability (units and segments) after 
using Turbo Pascal’s overlays. In es- 
sence, Turbo Pascal’s overlays are the 
equivalent of UCSD p-System’s seg- 
ments. I have grown fond of the UCSD 
p-System unit concept, especially for 
generating a large application pro- 
gram. For smaller jobs, however, the 
segment/overlay approach is more 
than adequate. 





Dynamic Heap Management 

Many lanaguages have the capability 
to dynamically allocate and deallocate 
variables and, more importantly, 
memory space. For example, Micro- 
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soft BASIC has its string variable gar- 
bage collection. Pascal has two ap- 
proaches: mark/release and new/ 
dispose. Turbo Pascal version 1.0 im- 
plemented the mark, release, and new 
procedures, but no dispose procedure. 
Version 2.0 now fully implements the 
dispose procedure, a nice 
enhancement. 

Why the fuss about dispose? Let’s 
look at how different the two Pascal 
approaches are, then you'll see why. 
Imagine some sequential stretch of 
memory where variables are stored. 
Under the mark/release approach, you 
specify a “mark” variable as the mem- 
ory pointer. When you later execute 
the release procedure with this “mark” 
variable, it and all variables stored af- 
ter it are erased. Hence, mark/release 
defines where new variable space starts 
by deleting a block of previous vari- 
bles. New/dispose works a bit differ- 
ently: these procedures use and make 
available variable space in a random 
fashion. When you “dispose” a vari- 
able, the memory space used by that 
variable can be reused when a new 
variable is specified by the “new” 
procedure. 

In summary, mark/release specifies 
a block of RAM for reallocation, and 
new/dispose specifies any variable 
space for reuse. One last comment: 
mark/release and new/dispose should 
never be used together—you must se- 
lect the approach you wish to use. 


IBM PC Goodies 
Now let’s get to the meat of the version 
2.0 enhancements: monitor control, 
graphics, color, sound, and windows 
for the IBM PC and its compatibles 
(see Table 2). Borland has been nice to 
us here; I just hope they can support 
other computers with these types of 
enhancements. 
Monitor control 
modes: 
(1) Text mode—25 lines of 40 or 80 
characters, color or black and white 
(2) Graph color mode—320 x 200 
dots, four color graphics 
(3) Graph mode—320 x 200 dots, 
black and white graphics 
(4) HiRes mode—640 x 200 dots, 
black and one color graphics. 
In text mode, after selecting the ap- 
propriate display format, you can de- 
fine both the background and the text 


includes four 
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colors using the color graphics board. 
You can select from any of 16 avail- 
able colors. Whichever monitor you 
use, the ““where cursor” functions give 
you the current x and y coordinates of 
the cursor. You can even have the text 
blink by selecting the text color with a 
blink offset (add 16). 

In the graph color mode, you have 
control over the background and pen 
colors. After selecting the background 
from one of 16 available colors, you de- 
fine the pen color according to which 
palette you are using (there are four). 
For example, palette(0) is composed of 
background, green, red, and brown. 
This will be the most used graphics 
mode. 

Graph mode is similar to graph color 
mode, except that background color is 
black and pen color is white. If you are 
using an RGB monitor, this mode is en- 
hanced: you can select a background 
color from the 16 available and a pen 
color from one of two palettes. 

In HiRes mode, you select only the 
pen color; the background is always 
black, independently of whether your 
monitor is color or black and white. 
The pen color is selectable from the 16 
available. 

Now, how do you use graphics? The 
plot procedure basically plots a point 
on the screen. The draw procedure 
plots a line between two points. In both 
cases, you have control of the pen col- 
or. The x and y coordinates for each 
point are defined with the origin (0,0) 
in the upper lefthand corner of your 
monitor; the lower righthand corner 
becomes either (319,199) or 
(639,199), depending upon the resolu- 
tion used. 

This orientation is the same as IBM 
BASIC, but different from my UCSD 
p-System Turtlegraphics where resolu- 
tion control is the same, but the lower 
lefthand corner is (0,0) and the upper- 
righthand corner is (319,199) or 
(639,199). I feel more comfortable 
with the latter, but most of us can use 
either approach. 

The area fills, circles, etc., of IBM 
BASIC are missing here, but these are 
not a great loss. One feature that I do 
miss from my Turtlegraphics is the 
ability to rescale the screen to use any 
coordinate system I wish. With a single 
statement, I could set the x-axis of a 
graph to be the years 1900 to 2000 and 
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nal re view of Turbo : 


oe 1 hae not ae disappointed: : 
The revised product has several im- 
_ provements, most of which will have — 
_ the biggest impact on users of the IBM 
PC and compatibles. That version is re-_ 


viewed by Kachigan starting page 107, 


- but the editors of Dr. Dobb’s let me 


look over the new 8-bit version as well. — 

The editor has been expanded slight- : 
ly with some additional commands, 
still similar to WordStar’s. The stan-— 
dard procedure, Dispose, has been im- — 


plemented. An additional new func- 


tion, MaxAvail, is provided that 


returns the amount of memory avail- 
able for allocation of dynamic storage. 


the FreeMem procedure is now pro-- 
_ vided to release blocks of dynamically 
allocated memory from the heap. It is 


symmetrical to the GetMem proce- : 


| dure previously provided. 


The big news for the 8-bit version is — 


the inclusion of dynamic overlay facili-_ 
ties. Truly huge programs can be built — 
_ with this facility. It allows you to speci-_ 
| fy procedures or functions that can be. 
| read into memory when required. It 
works this way: In the source file, the - 


new reserved word “overlay” is placed 
before the procedure or function 
keywords of those subroutines that you 

wish to run as overlays. Groups of sub- - 
routines declared consecutively in the 

program source will be placed in the 

same overlay file after compilation. At | 
runtime, routines from the same file 
will occupy the same space in memory > 
and will be retrieved from disk as they - 
are invoked. To place overlays in dif-— 


ferent overlay files, the routines must | 


be separated by the declaration of a 
nonoverlay object. A dummy type dec- | 
laration will do. Nested overlays are 
allowed to any depth. _ 

This overlay strategy places some 
restrictions on their use. Since overlays - 
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mory location, may. Also, since 


: tically during compilation, the 
ace in memory that they would occu- 
‘is not available for anything else; 





size when no overlays are executing. 
nally, programs with overlays must 
compiled to disk. You will cause 
mpiler error if you try to compile 
ha program in memory. 

“he : space requirement for this new 
xibility, is quite modest; it now re- 
ires 28K of memory to run Turbo on 
bit system instead of 27K. The 16- 
ersion, with windowing and all that 
- stuff, now takes 33K. In either 








Gat jeae L ovicwed this prod- 
the only thing | could find to com- 
about was the documentation. It 
't bad, just a little rough. It’s im- 
ing, it’s improving. Apparently 
ie of the errors in the programming 
imples were corrected before ver- 
n 2 was announced. Some other re- 
ons have been made to the manual 
s well. Some sections still grate on my 
ars, and some words are still broken 
t odd places, but the basically good 
nual has gotten better. 

Because of the improvements to the 
ae , | discovered a shortcoming that 
*t noticed in the original release: 

sere is no Exit procedure. Let me ex- 
lain. Because of the new overlay capa- 
ility, I transferred a big, nasty, vari- 
ble step size, variable order, variable 
ethod numerical integration program 
tten in UCSD Pascal to CP/M for 
with Turbo. That program was 
‘inally written in fairly unstructured 
tran. When the program runs, it is 
*n necessary to return from a deeply 
ested group of procedure calls without 
unwinding” back through them all. 

tandard Pascal can do this with a goto 
atement to any location in a program. 

SD Pascal allows gotos only within a 
sk, just like Turbo Pascal. As an al- 
lative, UCSD provides a standard 
cedure called Exit, which will exit 
m the subroutine named as its single 
ument. It is used when unwinding 
m a deeply recursive set of calls 
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t he s same 1e loca- . would be = 


in iene. they may not. call one © 
other, although overlays placed in a 
rate file, running at a different | 


mory space for overlays is allocated — 


: example, the heap: does not increase | 


ae is still an eee: small 






ply such a: echanism. 


The global goto: of standard Pascal is 
difficult to implement on a one-pass | 
compiler such as the Turbo and UCSD | 
products. An Exit procedure is fairly 


simple, though. It just involves travers- 
ing the chain of activation records un- 
til it passes the one sought. If anyone at 


Borland is listening, an Exit procedure 


would sure be nice. 
In summary, I found version 2.0 of 


_ | Turbo Pascal to be incrementally bet-_ 

| ter than its predecessor. The documen- 
tation is being polished up. The editor 
has been expanded slightly. A couple ‘ 
of useful new procedures have been in- 
cluded. The overlay facilities add a lot 
| of flexibility to an already excellent 
product. Maybe most important, these 
enhancements have not made the sys- 
tem large and unwieldy. Turbo Pascal | 
is still small, fast, a pleasure to use, and 


only $49.95. 
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the y-axis to be dollars from $1,000 to 
$10,000. To do this in Turbo Pascal, 
you have to define a special procedure 
to scale every x and y coordinate pair 
before you plot or draw. Also remem- 
ber that, because the x and y coordi- 
nates must be integers, you must trun- 
cate whatever your scaled values are 
back to integers or Turbo Pascal will 
not accept them. 

The first thing I tried after plotting 
the trace was to label my graph. You 
do this by overlaying text and graph- 
ics—with a few limitations. Charac- 
ters can be placed only in the grid of 24 
lines by 40 characters using the Go- 
toXY procedure, and the text color 
will be whatever the current pen color 
is. My Turtlegraphics lets me put a 
character or string at any point in the 
graphics screen. Graph labeling could 
be nicer, but at least Turbo Pascal has 
the same capability as IBM BASIC. 

Plotting speed is comparable to both 
IBM BASIC and UCSD p-System Tur- 


tlegraphics—not slow. Listing Two 


(page 119) illustrates a simple graph- 
ics program: a sine wave with axes and 
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a title for the plot. It took about 34 
seconds to plot everything, most of 
which was math computation time. 
When I removed the x and y computa- 
tions from the for/next loop and just 
plotted a fixed point, the program took 
less than 2 seconds! : 

Some final comments: Selecting any 
of the graphics modes will clear the 
screen; if you wish to clear the graphics 
screen, you must reselect the current 
graphics mode (the ClrScr procedure 
works only in text mode). If you have 
both monochrome and color monitors, 
you must work on only one of them— 
you cannot control both simultaneous- 
ly. And, finally, there is no way to get a 
hard copy of the current graphics 
screen. If I could add a few things, I'd 
like to be able to rescale the x and y 
axes and to have a graphics dump to 
my printer. These would make Turbo 
Pascal a superb graphics tool. 

Windows! We do windows! Yes, 
Turbo Pascal has windows for text and 
windows for graphics. In graphics, 
GraphWindow defines what part of 
the screen you can plot on. If you draw 
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a line that crosses through the window, 
only the pixels within the window are 
affected; everything outside it remains 
unchanged. In text mode, Window de- 
fines where the upper left screen coor- 
dinates (1,1) are. All console output 
appears only within the window, long 
lines wrap around the window, and the 
GotoXY function even works. 

Sound or NoSound now beep, play 
songs or make a siren (this is actually 
part of the SOUND demo program). 
Quite simply, you specify the tone fre- 
quency in Hertz with the Sound proce- 
dure, vary the time between tones with 
the Delay procedure, and turn off the 
sound with the NoSound procedure. 


Conclusions 

I am well pleased with Turbo Pascal. It 
sure comes close in many areas to my 
UCSD p-System Pascal. However, 
many of the standard Pascal features 
missing in version 1.0 are still missing 
here. They are: 

(1) The Get and Put procedures for 
I/O and the file buffer variables do not 
exist. You must use the extended capa- 
bilities of Read, Readln, Write, and 
Writeln to handle all 1/O. When 
translating from other Pascals, this 
will be a large stumbling block. 

(2) The Goto statement is restricted to 
transferring control only within the 
current block, not outside of proce- 
dures or functions. 

(3) The Page procedure is not 
implemented. 

(4) Variable packing and unpacking 
are not within your control; Turbo Pas- 
cal decides itself. Hence, the reserved 
word Packed has no effect, and the 
procedures Pack and Unpack are not 
implemented. 





(5) Procedures and functions cannot 


be passed as parameters to other 
subroutines. 

Although every Pascal attempts to 
follow Jensen & Wirth as a guideline 
to standard Pascal, very few can re- 
strain themselves from deviating on 
some functions and adding embellish- 
ments. Turbo Pascal adds its share of 
niceties to Pascal: The UpCase func- 
tion and screen commands (ClrScr, 
ClrEol, etc.) are a real help. Also, a 
simple access to CP/M and MSDOS/ 
PCDOS function calls is provided via a 
procedure and register record. 

I’d recommend Turbo Pascal to any- 


Dr. Dobb’s Journal, December 1984 


one interested in Pascal, whether nov- 
ice or expert. When I talked with one 
of Borland’s technical wizards, he 
clued me in to a version 3.0 that is 
coming in the next six months. A ma- 
jor planned addition is complete sepa- 
rate compilation capability. If that 
happens, Ill probably put away my 
UCSD p-System Pascal for good. It 
still shines in better screen control (via 
screen_ops), communications support 
(rem_unit), more enhanced graphics 
(Turtlegraphics), and separate compi- 
lation (units), but I’m sure the folks at 
Borland can come close. 

While I’m discussing what’s missing, 
let me give other UCSD p-System Pascal 


people a quick review of what needs to 
be translated from your UCSD p-System 
programs to make them Turbo Pascal 
programs. Not implemented: 

(1) units 

(2) exit 

(3) pwroften(*) 

Modifiable: 

(1) io_result—different error number 
(2) segments—overlays 

(3) screen_ops—various 
functions 

(4) close—different syntax 
(5) reset—must use assign and reset, 
different syntax 

(6) rewrite—must use assign and re- 
write, different syntax 


screen 


(7) turtlegraphics—quite a _ bit 
restricted 

(8 )strings—don’t default to 80 charac- 
ters long, there is no default length at 
all 

(9) underscore—Turbo Pascal doesn’t 
ignore them, they become significant 
characters in names. 


DD} 


a oo ee 


Sof f ware Re vie WS (Text begins on page 106) 


Listing One 


program over: 


{this demonstrates Turbo Pascal's overlay features. 


File: over.pas, over.com 
there are two overlay groups in this program 
Files: ovei>.@00 --- procla, procib 
over.@@1 --- proc2a, proc2b } 
type 
string8@ = string(8@l; 
var 


5: string8@; 


overlay procedure procla; 
begin 
Writeln( ‘This 
readin(s); 
end; 


overlay procedure proclb; 
begin 
weiteln( "This 
readin(s); 
end; 


procedure dummy; 


is the first procedure in overlay #1'); 


is the second procedure in overlay #1'); 


tthis forces the two separate overlay groups} 


begin 
end; 

overlay procedure procza: 
begin 


writeln( ‘This is the first procedure in overlay #2"); 
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1B: fabcode. CUM! Codesmith-86 


ee : 


"Also runs on some 1BM-PC Compatibles — 8\=0000(mmmm 600000 


2001 
2001 
2001 
2001 
2001 


ANGE 


ality 


2001: 
2001. 
2001: 


2001 
ally 


“0000 


“0001 


0004 
0007. 
-Q00C © 
O00E 


“0011 


“0019 
0018 


1984: 0050 
1984: 0060 
1984: 0070 
1984: 0080 





0013 
0015 
0015 


AX=8086 iSP=8087 


CX=0000 $i=0000 
0X—1136 mm O1=00005 


A 


— §BDEC2 FADDP = ST (2), a7 


fig ts” MOV BX,Offset VECTOR _ TABLE _2 
scsE- CMP _ DOS_VERSION_NUM,'2’ —_;BREAKPOI 
nGrrrtrts~—~—s™ JAE SsSCTRASH_IT 

foie ttiti=ts — MOV BX,Offset VECTOR _TABLE_1 

EBO2 JMP Short LONG_LABELS _ARE_OK_AS_ YOU 


eye 00777) ee ‘STOP 7771 


LONG LABELS _ARE_OK _AS_YOU_LIKE: 
BDADES - LEA BP,WIERD_CODE + 2(DI) 
AND AL, 000111008 ; CHANGE RA 


Segment: Offset=0304:005E 
ASCI| SUPPORT @ 
9) 20 90 20 43 GF 64 G5-33 OD 69 /4 68 cD 38 36 -- CodeSmith-86 
20 40 41 4B 45 53 20 44-45 42 65 47 47 49 46 4/ MAKES DEBUGGI 
99 41 20 42 40 41 83 54-21 20 20 20 20 20 co cl A BLAST! 
:  - | WNOW 2 LVL 1 








Sof f ware Re Vi ews (Listing Continued, text begins on page 106) 
Listing One 


readin(s); 
end; 


overlay procedure proc2zb; 
begin 
weiteln( ‘This is the second procedure in overlay #2'); 
readin(s); 
end; 


begin 
clrser; 
weiteln( ‘Disk acce 
procla; 
writeln( ‘Disk ac 
procza: 


For overlay group #1'); 


‘ey 
hi 


for overlay group #2"); 


C1 
iat) 
ui 
U1 


writeln( "Disk access for overlay group #1'); 
proclb; 
Weiteln( "Disk access for overlay group #2°); 
proceb; 
weiteln(‘Done'?); 
end. End Listing One 


Listing Two 


drogram graph; 
tdemonstrates Turbo Pascal graphics) 


var 
Ss: stringl6@]; 
pil8@: real; 
i,x,y: integer: 


begin 
graphcolormode: tset 320 « 200 color graphic 
graphbackground(@); {set background to black} 
palette(@); tcolors are black/green/red/brown} 


draw(@,@,@,199,1); 
draw’) ,199 519,199.14; 

drawl SES, £995318.0,1); 
draw(319,0,8,0,1); {draw a frame} 


draw(@,100,319,1@@,1); {draw center line} 
gotoxy(6,2); 
weiteln( ‘This is a Turbo Pascal Graph’); 


pil&@:=3.14/180; 
For i:=@ to 72@ do 
begin 
x: =terunc(i/2); 
y:=trunc(1@0+7S*sin(i*pil8e@)); 
gy a ae gern Aas Be {draw a sine wave} 
end; 


end. End Listings 
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CROSS SOFTWARE 
for the NS32000 


Also Available for IBM PC 
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* Cross Assembler * 
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* Pascal Cross Compiler * 
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SOLUTIONWARE 
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Suite B 
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A general purpose programming 
language for string and list 
processing and all forms of 

non-numerical computation. 


SNOBOL4+ —theentire 


SNOBOL4 language with its superb pattern-matching 


facilities * Strings over 32,000 bytes in length © Integer 
and floating point using 8087 or supplied emulator yo 
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COMPUTER CALISTHENICS 





by Michael Wiesenberg 


Bob Levin, hotshot young programmer 
at I-Q Industries in the heart of Silicon 
Valley, stands at one of I-Q’s perma- 
nent coffee stations and stares forlorn- 
ly at the empty coffee pot. The burner 
has been on all night and all that re- 
mains in the pot is a dark brown paste. 

Grey Scrivener, senior technical 
writer, glides around the corner. He 
smiles as much at Levin’s predicament 
as at his tattered tennis shoes, wrinkled 
wash pants, and TEX t-shirt (“!You 
can’t do that in horizontal mode’’). 
Scrivener smooths an invisible wrinkle 
in his Calvins and takes over. He car- 
ries the pot into the men’s room and 
washes out the muck. When he re- 
turns, Levin has been joined by Spots- 
wood Gilbert, senior programmer, who 
holds a raisin Danish in one hand and a 
chocolate brownie in the other. 

Marian Smith, system operator, ar- 
rives, trailing a cloud of smoke, which 
Scrivener fans away with his hands. 
She sets her cigarette on the edge of 
the table. Burn marks on the table in- 
dicate that she has probably done this 
before. “Baby Huey’s down. You been 
messing with the operating system 
again, Bobby?” 

“The changes I make only speed the 
system up. If it’s down again, you can 
blame all the unsupported utilities. 
You’d think a company as big as this 
would get a full-screen editor for pro- 
gram development.” 

Sally McRae walks up, having over- 
heard the last part of the conversation. 
She has on Nikes, baggy shorts over 
purple tights, and a Cocolat t-shirt. 
‘Maybe you didn’t crash the system, 
but you sure brought it to its knees. 
What’re you doing to use up all that 
cpu time?”’ 

Levin, uncomfortable around at- 
tractive women, is too embarrassed to 
look McRae in tlie eyes, so he settles 
on her nose. “I’m trying to solve a 
puzzle.” 
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Gilbert takes the last bite of his 
Danish and starts on the brownie. “Is it 
as tough as that last one?” 

‘“‘Nah. This was a contest by a puz- 
zle magazine. Winner got a new 
1Q2557Q portable computer.” 

Smith notices the veneer top of the 
coffee station table starting to char 
and shoves the cigarette back in her 
mouth. “Hey, I’d like one of those. 
Even with the employee discount, 
they’re not cheap.” 

“Well, the funny thing is I don’t 
think the winner used a computer to 
come up with the winning answer. I 
think a computer could have found a 
better solution.” 

Scrivener adjusts his Stanford ring. 
“You mean this puzzle had more than 
one answer?”’ 

“No, but I’m pretty sure there’s a 
better answer than the one that won 
the contest. I just don’t think any of the 
entrants found it because I don’t think 
anybody knew how to write a program 
to solve the problem. I wish [I'd heard 
about it before the contest was over. | 
have a program running right now that 
should give me the answer that would 
have won. Listen: 

“Assign a numerical value to each 
letter of the alphabet, starting with 1 
for A and going up to 26 for Z. Any 
word in the English language has a val- 
ue obtained by multiplying the values 
for each of its letters. For example, the 
word hello is worth 86,400, obtained 
by multiplying 8 X 5 X 12 X 12 X 
15. Which English word is equal to ex- 
actly 1,000,000? If there is none, 
which is closest? Only words found in 
The Random House Dictionary of the 
English Language (unabridged edi- 
tion) can be used. No capitalized 
words, none with hyphens or other em- 
bedded punctuation, nor those desig- 
nated as foreign.” 

McRae laughs. ““How about a pro- 
gram that does my work for me at noon 





while I drive to Gelato Classico?” 

Gilbert finishes the brownie and 
pours the last of the coffee. “Hmm. I 
can see right away that the word has to 
have at least five letters.” 

Scrivener dumps the old filter and 
grounds, measures fresh coffee into a 
new filter, replaces the holder, and 
presses the BREW button. “I see that. 
The four-letter combination with the 
highest value would be zzzz, and that 
multiplies out to considerably less than 
a million.” 

Gilbert presses buttons on his watch. 
“How about linger? That’s 952,560.” 

Levin pushes the straggly blond hair 
off his forehead. “That’s 47,440 off, 
and you’re just guessing. I can give you 
a better guess: single. That’s 
1,005,480, only 5,480 off. But there’s a 
scientific way to figure it, and I’m sure 
it can be done only by computer.” 

* * * * * 

Well, how about it, folks? Can you 
devise a program that finds the right 
word? And, having done that, can you 
tell us what that word is? Your pro- 
gram must be short and elegant. The 
algorithms can be demonstrated in a 
good pseudolanguage if you wish or 
perhaps in flowcharts. The best solu- 
tion wins a t-shirt and will be pub- 
lished here. 


DDJ 
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WIZARO C 


Fast compiles, fast code and great diagnostics 
make Wizard C unbeatable on MSDOS. Discover 
the powers of Wizard C: 
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And if you leave an undefined variable or data type, 
the editor detects the mistake and gives you the option 
of on-line “help” to correct it. No other programming 
text editor offers you this much innovation. 


INTRODUCING 
Interface Technologies’ Modula-2 
Software Development System 





The computer press is hailing Modula-2 as “the next 
standard in programming languages.” Modula-2 
combines the strengths of its popular predeces- 
sor—Pascal—with the features that made the C 
language appealing, like independent com- jg 
pilation and direct hardware control. 

But until today, no company offered a} 
Modula-2 system that made software develop- } 
ment fast, easy and efficient. 


The fast, powerful tool 
for programmers 


Now that breakthrough is here: Interface Technol- 
ogies’ Modula-2 Software Development System for 
the IBM® PC, XT, AT and compatible 
computers gives programmers the same 
quantum leap in productivity that spread- 
sheets and word processors gave to end- 
users. It can reduce monotonous wait 
time, dramatically increase speed, help 
eliminate thoughtless mistakes, and free you to become 
more creative in all your programming efforts. 





How to speed input and 
eliminate 30% of errors 


Thirty percent of programming mistakes are syntax 
errors and simple typos in the program structure. Our 
“syntax-directed” Modula-2 editor does away with 
these time-consuming headaches forever. 

. It also speeds input 
by reducing manual typ- 
ing as much as 90%, let- 
. ting you enter statements 
with a single keystroke. 
For example, if you type 
a capital “I” at the be- 
ginning of a line, the editor 
completes the logical “IF 
THEN” statement auto- 

7 = matically, so you can concen- 
Enter complete statements trate on what you want to 
with one keystroke. program, rather than your typing. 

The editor locks out errors, finishing each statement 
and procedure in perfect accord with the standard- 
ized rules of Modula-2. It also indents and formats 
your text automatically, making programs easy to read 
and maintain, an important feature on big projects. 
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How to turn “wait time” 
into “work time” 


Most of a program- 
mer’s time is spent 
waiting, and the biggest 
culprit is usually the 
compiler. Our compiler 


compilation. ro) b 
With background 


compilation, every moment you spend writing or edit- 
ing a Modula-2 program, it’s automatically being 
compiled into object code, line by line as you work! 

When you’re finished editing, all that’s left for the 
compiler to do is a quick mopping up that generates 
optimized native code in a single pass. 

How quick is “quick”? 

Thanks to background compilation and the fact that 
the compiler itself is so fast, Interface Technologies’ 
compiler can turn 100 lines of typical Modula-2 pro- 
gram text into optimized machine code in less than 
five seconds. 

And the Interface Technologies Modula-2 Software 
Development System compiler produces compact 
code that has execution speed superior to that pro- 
duced by any other Modula-2 compiler presently 
available to individuals and firms involved in soft- 
ware development. 


The Interface Technologies Modula-2 
Software Development System saves 
time by compiling while you edit. 






turns this wait time 
into work time, witha 
technical innovation 
we call “background” 





How to do two things at once 


Along with the syntax-directed editor and back- 
ground compilation, Interface Technologies’ Software 


Development System gives your screen multiple 
windows so you can refer to one file while 
you edit another—simultaneously. 

Concurrent editing of 
multiple files is particularly 
useful when you’re doing 
programming work intended 
for separate compilation, and 
Interface Technologies has 
the only Modula-2 develop- _ 
ment system on the market 
that provides you this help- 
ful benefit. 





Work with multiple files 
faster, easier in windows. 


How preprogrammed modules 
speed development 


One of the advantages of Modula-2 is that it lets you 
build large, reliable programs quickly, by linking 
smaller “building-block” modules. 

The development system’s toolkit of precompiled 
program modules includes the standard Modula-2 
library, and adds exclusive link-and-run modules for 
color graphics support, sound, and direct calls to the 


ogies’ growing 


| Operating sys- 
j sau 
library of pro- 


tem. Plus you get 
gram modules. 
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Turn big programs into smaller projects 
with ready-made modules. 














face Technol- 





Increase productivity for $249 


Interface Technologies’ Software Development 
System is fast, powerful and unlimited. It works so well 
that it’s the same tool Interface Technologies is using to 
write business and consumer applications in Modula-2. 

For $249, you get the syntax-directed editor and 
compiler, linker, module library and tutorial that will 
have even modestly experienced programmers writing 
in Modula-2 in days. And you have full rights to your 
work; there’s no license fee for programs you develop 
with our system. 





You can use it on any IBM® PC, XT, AT 
or compatible with two DSDD floppy drives and 
320K RAM. 

You get a thoroughly indexed, comprehensive user’s 
manual and free telephone support from Interface 
Technologies. 

But the most important thing you get is the future, 
and the programming language of the future is 
Modula-2. 

For more information, or to order the Modula-2 
Software Development System, call | -800- 922-9049 
today. In Texas, call 
(713) 523-8422 

To order 
by mail, or 
to request 
further infor- 
mation, fill 
out and mail 
the coupon 
below. 
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by R. P. Sutherland 
Unix Directories 


The Unix market is growing at a fran- 
tic rate. The number of licenses for 
Unix and Unix imitations is a quarter 
of a million and that figure is projected 
to quintuple over the next two years! 
Two Unix software directories con- 
taining 400 sources each can put folks 
in touch with suppliers of Unix appli- 
cations software. Onager Publishing 
has announced the second edition of 
Unix Applications Software Directo- 
ry. Cost: $50.00. Onager Publishing is 
at 6451 Standridge Ct., San Jose, CA 
95123 (408) 225-3541. Another re- 
source is the Unix System Encyclope- 
dia. In addition to alphabetical and 
categorical listings of sources and pro- 
grams, a third of the book includes ar- 
ticles that describe hardware systems 
and industry trends. The Unix System 
Encyclopedia is priced at $34.95, 
available from Yates Ventures, 4962 
El Camino Real, Suite 111, Los Altos, 
CA 9402? (415) 964-0130. 








Unix Utilities 


A $90 Modula-2 system for the For- 
tune 68000 system running Unix is 
available from Modula-2 Corporation. 
The system allows 128K of workspace 
for Modula-2 programs, which may be 
divided between code and data in any 
ratio. The compiler and interpreter are 
supplied with the basic I/O modules 
described by Wirth in Programming in 
Modula-2. Modula Corporation is at 
1673 West 820 North, Provo, UT 
84601 (800) LILITH2. Reader Service 
No. 101. 

A Writer’s Workbench for Unix 
System V and 4.1 and 4.2 Unix sys- 
tems is available from International 
Data Services. Writer’s Workbench 
consists of 25 computer programs that 
will do such things as proofread text, 
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analyze spelling and punctuation, and 
check for sentence length, structure, 
and voice. Writer's Workbench pro- 
vides on-line information about En- 
glish usage and allows users to estab- 
lish their own standards for text 
analysis. Writer's Workbench is dis- 
tributed at a cost of $2,000.00. Call In- 
ternational Data Services at (408) 
986-1972. Reader Service No. 103. 





C Tools 


Complete Software, Inc., and Cataly- 
tix Corporation, both of Cambridge, 
Massachusetts, have announced some 
interesting C tools. Complete Software 
has introduced a menu-driven C lan- 
guage debugger that operates indepen- 
dently of host systems. CDEBUG is an 
interactive tool that symbolically de- 
bugs C source code routines on any 
software or hardware that runs C. 
Priced from $300.00, CDEBUG is 
available from Complete Software, 
Inc., 60 Aberdeen Ave., Cambridge, 
MA 02138 (617) 492-5305. Reader Ser- 
vice No. 105. Catalytix Corporation has 
a checkout compiler for the C pro- 
gramming language as well as a C in- 
terpreter. The Safe C Compiler adds 
runtime checking to C programs. The 
Safe C Interpreter provides interactive 
execution of C programs. Catalytix 
Corporation is at 55 Wheeler St., 
Cambridge, MA 02138 (617) 497- 
2160. Reader Service No. 107. 

C Compilers for Macintosh and Lisa 
are available from Softworks Limited 
and Consulair Corp. Softworks Limit- 
ed has a triple pass compiler system. 
The C library includes system inter- 
face functions, Unix functions, and 
complete interface to all Macintosh 
ROM routines. The Lisa implementa- 
tion will produce programs for either 
Macintosh or Lisa. The package is 
$395.00 for Macintosh and $695.00 


for Lisa. Contact Softworks Limited, 
607 W. Wellington, Chicago, IL 
60657 (312) 975-4030. Reader Service 
No. 109. Consulair Corp. is shipping a C 
compiler and support library for the 
Macintosh (or Lisa under Mac- 
Works). Use of Mac C and the Mac C 
Toolkit requires Apple’s Macintosh 
68000 Development System (assem- 
bler /debugger). Mac C is $295.00 and 
Mac C Toolkit is $175.00. Consulair 
Corp. is located at 140 Campo Drive, 
Portola Valley, CA 94025 (415) 851- 
3849. Reader Service No. 111. 





Apple Stuff 


A cross assembler that allows develop- 
ment of MC68000 assembler pro- 
grams on Apple II computers has been 
made available for $100.00. Allen Sys- 
tems’ SX-68 cross assembler is written 
in 6502 assembler. Complete access to 
DOS 3.3 as well as the instruction set 
specified by Motorola for the 
MC68000 are supported. Allen Sys- 
tems, 2151 Fairfax Road, Columbus, 
OH 43221 (614) 488-7122. Reader Ser- 
vice No. 113. 

DOS 4.0 for the Apple II family has 
been released by Rune Software for 
$95.00. The company claims that DOS 
4.0 offers better performance than 
DOS 3.3 because it employs a new 
CMOS 6502 instead of the Apple II’s 
existing NMOS 6502. Advantages in- 
clude faster processing, increased disk 
storage capacity, as well as eight new 
processor instructions. For a full list of 
features, contact Rune Software at 80 
Eureka Square, Suite 214, Pacifica, 
CA 94044 (415) 355-4851. Reader Ser- 
vice No. 115. 

Assembly language programming 
on the Mac for the Mac is possible 
with MacASM, a co-resident editor/ 
macro assembler. MacASM integrates 
the editor, assembler, linker, resource 
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Source Code Included 
The Softfocus B-Trees record index- 
ing library will helo you develop 
sophisticated application programs. 
With Softfocus B-Trees you get: 
@ high speed file handling for up 
to 16.7 million records per file 
e customizable BDS orK &R 
Standard C source code 
@ no royalties on applications 


CROSS-DEVELOPMENT 
SOFTWARE TOOLS 


Now With Windowing! 
$49.95 Basic Compiler _ 
Features: 
Multitasking Windowing 
Handles interrupts _ Interactive 


Fast native code Compiles quickly 
Floating point No runtime fee 









C COMPILERS (with ROM support) 


host}IBM/PC, target | 6809 
PDP-11, 
6809 


MACRO ASSEMBLERS 


host]|IBM/PC, target | 6801, 6805 
PDP-11, 68HC11, 6809, 
6809 16000, 68000 


IBM/PC: TM of Int'l Business Machines. 



















MTBASIC is a true native code compiler. It runs Bytes's Sept. 
‘81 seive in 26 seconds; interpreters take over 1400 seconds! 
Because MTBASIC is multitasking, it can run up to 10 Basic 
routines at the same time, while displaying ten separate win- 
dows. Pop-up/down menus are a snap to implement. 









MTBASIC combines the best of interpreters and compilers. To 
the programmer, MTBASIC appears to be an extremely fast 
interpreter. MTBASIC compiles a typical 100 line Basic pro- 
gram in 1 second, yet it generates blindingly fast code. No 
more waiting for long compiles. 
























programs | ici: carta Chad Re hagas PDP-11: TM of Digital Equipment Corp. 
e support random and sequential melee. nt tients By. pi caae 
file access ORDERING: Specify format when ordering. We accept Visa, 
; MC, checks and COD. Send $49.95 plus $3.50 shipping and 
@ includes example programs handling ($10 overseas) to: 
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SOFIAID, Inc. 


P.O. Box 2412 Columbia,MD 21045-1412 
301/792-8096 
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CHARGEX 


1277 Pallatine Dr., Oakville, Ont. Sarre 
Canaca L6H 121 (416) 844-2610 = 









ms O47 W. Virzinia St. 
2 ae Milwaukee, WI 53204 
a (414) 276-2937 
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microSUB:MATH 





68000 Cross Assembler 


: New Release 
Motorola VERSAdos + Compatible 








Assembler, Linker, Object and Macro Librarian. 
Absolute and Relocatable Code, Macros, In- 
cludes, and Conditional Assembly. Structured 
Programming. No limit on source file size. 







Unix (C) Compatible Source 
$700 


PC/DOSt CP/M-86* 
$250 $250 


Manual: $20 
(refundable) 







CP/M-80* 
$200 


















@ farbware 







1329 Gregory 
Wilmette, IL 60091 


(312) 251-5310 
after 5 p.m. 








“Digital Research trademark, tiBM trademark, + Motorola trademark. 
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SPECIAL ONCE-ONLY OFFER 


CP/M + (3.0) Source Listing 
about 140 pages with 


excellent comments. 


Listing only 
price US$ 200.- 


Listing incl. 2 Disks (8" 
SS/SD) US$ 230.- 


Terms: Check or prepaid 


order only. 


Orders to: 

CP/D oHG, West Germany 
Vulkanstr. 13 

4000 Duesseldorf 
phone: 211-784278 

tx: 858 8060 


CP/M is a trademark of 
DIGITAL RESEARCH 
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CP/M~<—>- ISIS 


for 
PDS & MDS 







ICX v.4 eXchanger now supports BOTH 8” 
MDS and 5-1/4" iPDS formats. 
Manipulation of ISIS-II files using your 
CP/M system was never easier. 


ISE v.6 Emulator gives the CP/M-80 user 
access to all the ISIS-II languages and 
utilities. 













Complete source (C and MAC asm) 
included with all packages 
Me Sei Vek MOLT eee ad 







eoeoeeeeeeeeceoee eee eee ee eee es 





Copyrights: CP/M Digital Research, Inc 
ISIS-II and iPDS Intel Corp 


A 


ee 
Se Wester n Wear ES 


303-327-4898 Box C * Norwood, CO 8142 
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TEK-MAR 


HIGH-LEVEL FORTRAN 
GRAPHICS LIBRARY 
FOR THE IBM PC 


Features: 
¢ Windowing ® Viewporting ® Clipping 
¢ Axis Rotation ¢ Screen Dump & Restore 
¢ Dump Screen Graphics to Epson 


INCLUDES EXAMPLE 
APPLICATION SOURCE CODE 


REQUIRES: 
e¢ 320K Memory * Two DS Disk Drives 
¢ TecMar Graphics Master Board 
¢ MS Fortran 3.20 or higher 
¢ Optional Plotter (Western Graphic 4636) 

$195 


ADVANCED SYSTEMS CONSULTANTS 
18653 Ventura Boulevard, Suite 351 
Tarzana, California 91356 
(818) 990-4942 
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503/884-3023 


A library of Numerical Methods Subroutines 
for use with your FORTRAN programs. 





Over sixty subroutines of: 


FUNCTIONS INTERPOLATION 
INTEGRATION LINEAR SYSTEMS 
MATRICES POLYNOMIALS 





NON-LINEAR SYSTEMS DIFFERENTIAL EQ 


Versions now available for 
MS-DOS: IBM FORTRAN-77 
SuperSoft FORTRAN IV 
Microsoft MS-FORTRAN ver 3.2 
DRI OR FORTRAN-77 


CP/M-80: Microsoft F-80 
SuperSoft FORTRAN IV 


LICENSE, $250. 
with SOURCE CODE, $600. 
(Manual alone, $25.) 


NVA 
SUBROUTINE 
(LUISIRVARRYY 


TRADEMARKS 
Microsoft & icrosoft Corp 
CP/M & DR FORTRAN.-77 : Digital Research Corp 
1BM : Interna’ tional Business Machines 
SuperSott : SuperSoft Corp 


foehn consulting, PO Box 5123, Klamath Falls, OR 97601 
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BIG DISCOUNTS 
ON LITTLE BOARDS ™ 
& ACCESSORIES 











e@ AMPRO LITTLE BOARD” —64K, Z80a CPU. CTC. 
DART, 1 parallel port, 5% controller supports four 
48tpi and/or 96tpi drives w/ CP/M 2.2 and ZCPR3 







[A Geta igs ao eas tee from $329 
e@ SYSTEM SUPPORT PKG-—Manuals. source code 
schematics, connectors & cables ......... $99 






e@ SCSI PLUS—DMA Hard disk interface $99 
e@ TEAC 55B DSDD 48tpi “ht drive ........ $195 
@ TEAC 55F DSDD 96tpi 2 ht drive... ... $239 
@ INTEGRAND Custom two drive cabinet with 5 amp 

power supply & power cables ............ $199 
@ TERM-MATE-Cabinet for 2’ ht + LITTLE BOARD 

w/ all cables & supply ................. $229 
@ AMPRO SERIES 100 compiecte systems... $CALL 


VISA & MASTER CHARGE. personal checks. 

Please allow 2 weeks. Shipped via UPS. 

Prices F.0.B. Prairie View. IL 

For additional information write or call: DISKS PLUS, 
15945 West Pope Blvd., Prairie View, IL 60069 
(312) 537-7888 


OtviStON OF SO 


LARONICS INC 
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compiler, and debuggers so that they 
can be used from the MacASM full- 
screen environment. Source files gen- 
erated by MacASM can be edited with 
MacWrite, and vice versa. Introduc- 
tory price is $100.00, from Mainstay, 
28611B Canwood Street, Agoura 
Hills, CA 91301 (818) 991-6540. Reaa- 
er Service No. 117. 

Pterodactyl Software has developed 
PC BASIC, a Basic compiler for the 
Apple Lisa. PC BASIC is syntax com- 
patible with BASICA on the IBM PC. 
This product allows Basic programs to 
be quickly converted to run on the 
Lisa. In addition, PC BASIC provides 
nearly unlimited core memory space 
for programs and data, and allows de- 
velopers to link programs to Lisa’s 
graphics operating system, as well as 
Lisa’s Pascal and 68000 programs. 
Cross-compiled and native mode ver- 
sions for the Macintosh will be avail- 
able soon. The price for one protected 
copy of the compiler is $250.00, or 
$750.00 for a runtime license that al- 
lows one to include the runtime pack- 
age with applications for resale. Con- 
tact Ed Rosensweig at (415) 485-0714. 
Reader Service No. 119. 





Miscellany 


DriveLiner 

Chandler Software has developed a 
portable CP/M program for verifying 
alignment of 8-inch floppy disk drives. 
A Dysan Diagnostic Diskette (see 
Loren Amelang’s article in the Decem- 
ber 1983 DDJ) is supplied with the pro- 
gram. Head centering, radial, and azi- 
muth alignment tests are performed 
automatically on any CP/M 2.2 com- 
patible 8-inch floppy system. The price 
is $65.00 from Chandler Software, 273 
West Shore Drive, Marblehead, MA 
01945 (617) 631-4685. Reader Service 
No. 121. 


DDJ 


Reader Ballot 
Vote for your favorite feature/article. 
Circle Reader Service No. 200. 
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Artwork 


Professional graphics capability on a 
personal computer for $500.00 (IBM 
color graphics card) is possible with 
Artwork, an interactive graphics-design 
program. With the use of an input tab- 
let or mouse, a designer can draw, mod- 
ify, edit, and store complex graphic ele- 
ments. Artwork includes a library of 
type fonts that can be scaled, rotated, 
italicized, or condensed. The fonts are 
vector-defined, not bit-mapped, so they 
can be changed like any other image 


created by Artwork. The program also 
offers three-dimensional graphics ma- 
nipulation capability. Images created 
by Artwork can be retouched by Art- 
paint and vice versa. The two programs 
are designed to complement each other. 
Live images from a video camera can 
be captured and manipulated by Art- 
paint. Address: West End Film Inc., 
2121 Newport Place, NW, Washing- 
ton, DC 20037 (202) 223-2938. Reader 
Service No. 125. 


PC/AT Internal Expansion Kit 


A hard disk and 1/4-inch tape drive 
internal upgrade kit for IBM’s PC/AT 
converts the AT into a virtual main- 
frame. The kit uses IBM’s hard disk 
controller. The Back Up and Restore 
Utility backs up 65 megabytes in 12 
minutes. The system also allows user- 
configurable disk caching of up to 4 


megabytes. The kit (which fits inside 
the AT’s casing) is available in 40, 70, 
140, and 280 megabytes. The internal 
280 megabyte hard disk kit is priced at 
$15,850.00 from Emerald Systems 
Corporation, 4901 Morena Boulevard, 
San Diego, CA 92117 (619) 270-1994. 
Reader Service No. 123. 
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More power 
CO you. 


pennommennceats 


you have to know is what you 
want it to do. 

Our new tutorial/manual 
will have pi be entering and 
viewing data in minutes rather 
than reading for hours. 

And to make matters 
easier, you get a full screen 
report setup for simple infor- 
mation access. 


Faster than no time at all. 


dBASE III isn’t just fast. It’s ultra-fast. 
Operating. And sorting. Even faster, is no 


Remember the magic you 
expected when you first purchased 
a PC? 

It's here. 

dBASE III™ is the most power- 
ful database management system 
ever created for 16-bit 
microcomputers. It pulls 
every ounce of energy 
out of your PC and puts 
it to work. 

On top of that, it’s 
fast and it's easy. 








You've never seen mam sorting. Because dBASE III keeps your 
anything like it. records in order, so you really don’t have to 

dBASE III can handle over a billion sort anything. Unless you want to. Then 

records per file, limited only by your com- watch out! 

puter system. You can have up to ten files What about dBASE II°? 

open, for sophisticated applications pro- It's still the world’s best database man- 

ts. tee agement system for 8-bit computers. And 
When you have two related files, infor- it's still the industry standard for account- 

mation In one can be accessed based upon ing, educational, scientific, financial, busi- 

data in the other. ness and personal applications. 


dBASE III now handles procedures, Tap into Gus bance 
parameter passing and automatic variables. P Pp ° 


: For the name of your nearest authorized 
You can include up to 32 procedures in a y 
single file. With lightning speed. Because dBASE III dealer, contact Ashton-Tate, 10150 


West Jefferson Boulevard, Culver City, CA 
90230. (800) 437-4329, ext. 333. In Colorado, 
(303) 799-4900. | 


once a file is opened, it stays open. And 
procedures are accessed directly. 
Easier than ever. 
dBASE III uses powerful yet simple 


commands that are the next best thing to rM 
eating ASHTON ‘TATE 


If you're unsure of a command, HELP 
will tell you what to ask for. 
/ 
If ‘bla don : know what ris and © Ashton-Tate 1984. All rights reserved. dBASE III and Ashton-Tate are 
Comes next, a command assistant does. All trademarks and dBASE Il isa registered trademark of Ashton-Tate. 
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DeSmet 





8086/8088 


Development 
Package 


FULL DEVELOPMENT PACKAGE 


Automatic DOS 1.X/2 X SUPPORT 

BOTH 8087 AND S/W FLOATING POINT 
OVERLAYS 

OUTSTANDING PERFORMANCE 


DOS LINK SUPPORT 


109 













Full K&R C Compiler 

Assembler, Linker & Librarian 
Full-Screen Editor 

Execution Profiler 

Complete STDIO L'hrary (>120 Func) 


First and Second in AUG ‘83 BYTE 
benchmarks 


Examine & change variables by 
name using C expressions 


Flip between debug and display 
screen 


Display C source during execution 
Set multiple breakpoints by function 


or line number 


















Uses DOS .OBJ Format 
LINKs with DOS ASM 
Uses Lattice’ naming conventions 


128 


Check: (1 Dev. Pkg (109) 


SHIP TO: 








All orders shipped UPS surface on IBM format disks 
Shipping included in price. California residents add 
sales tax. Canada shipping add $5. elsewhere add 
$15. Checks must be on US Bank and in US Dollars 
Call 9 am - 1 pm. to CHARGE by VISA/MC/AMEX 


1) Debugaer (50) 
O DOS Link Supt (35) 


WARE 


CORPORATION 





P.O. BOX C 
Sunnyvale, CA 94087 


(408) 720-9696 


Sr ES ee eee 
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Include $3.00 shipping. COD, VISA and MASTERCARD accepted 
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MICKOTEC 
RESEARCH 


VA 


3930 Freedom Circle, Suite 101, Santa Clara, CA 95054 
Mailing Address: PO. Box 60337, Sunnyvale, CA 95088 
(408) 733-2919 Telex (ITT) 4990808 
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BORLAND <<. 


INTERNATIONAL 


GIFT PACK A SAVINGS OF $30! 


What a gift for you and your friends! The extraordinary TURBO 
PASCAL compiler, together with the exciting new TURBO TOOLBOX 
and new TURBO TUTOR. All 3 manuals with disks for $99.95. 


Version 2.0 (reg. $49.95). The now classic program 
development environment still includes the FREE MICROCALC 
SPREAD SHEET. Commented source code on disk 
¢ Optional 8087 support available for a sniall additional charge 


NEW! (reg. $49.95). A set of three funda- 
mental utilities that work in conjunction with TURBO PASCAL. 
Includes: 


¢ TURBO-ISAM FILES USING B+ TREES. Commented source code 
on disk 

© QUIKSORT ON DISK. Commented source code on disk 

e GINST (General Installation Program) 

Provides those programs written in TURBO PASCAL with a terminal 

installation module just like TURBO’S! 

e NOW INCLUDES FREE SAMPLE DATABASE — 

NEW! i -treg. $29.95). Teaches step by step how to 

use the TURBO PASCAL development environment—an ideal 

introduction for basic programmers. Commented source code for all 

program examples on disk. 


30 DAY MONEY BACK GUARANTEE 
These offers good through Feb. 1, 1985 


For VISA and MASTERCARD order call toll free: 
1-(800)-255-8008 1-(800)-742-1133 

(Lines open 24 hrs., 7 days a week) 

Dealer and Distributor inquiries welcome (408) 438-8400 


CHOOSE ONE (please add $5.00 for handling and shipping U.S. orders) 





All Three-Gift Pack $ 99.95 + 5.00 

All Three & 8087 139.95 + 5.00 

Turbo Pascal 2.0 49.95 + 5.00 

Turbo Toolbox 49.95 + 5.00 

Turbo Tutor 29.95 + 5.00 

Turbo 8087 89.95 + 5.00 
Check Money Order VISA MasterCard 
Cade CC ats 2 Shipped UPS 
My system is: 8 bit 16 bit 
Operating System: CP/M 80 CP/M 86 Ms DOS PC DOS 
Computer: Disk Format: 
Please be sure model number & format are correct. 

NAME: 





ADDRESS: 
CITY/STATE/ZIP: 
TELEPHONE: 


California residents add 6% sales tax. Outside U.S.A. add $15.00 (if outside of 
U.S.A. payment must be by bank draft payable in the U.S. and in US. dollars). 
Sorry. no C.O.D. or Purchase Orders Gll 


BD) BORLAND 


B®) | NTERNATIONAL 


4113 Scotts Valley Drive 
Scotts Valley, CA 95066 [ 
TELEX: 172373 | 
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